nl::Weave::Profiles::BDX_Development

Questo gestore viene chiamato ogni volta che si verifica un errore Weave che non può essere restituito direttamente tramite codici di errore al flusso di controllo definito dall'applicazione dall'utente.

In altre parole, se un errore si verifica all'interno di un altro gestore la cui firma ha restituito tipo void (ad esempio in risposta a un messaggio Weave in arrivo o anche inviato dal protocollo), questo gestore verrà chiamato in modo che l'utente possa determinare se il trasferimento può essere recuperato e continuare o se deve chiamare Shutdown(). Tieni presente che è possibile che si verifichi un errore prima che un BDXTransfer venga inizializzato (ad es. troppi oggetti assegnati). In tal caso, l'errore viene registrato da Weave e il protocollo gestisce la pulizia degli stati allocati necessari.

Get a block of data to be transmitted.

Il chiamante fornisce lo spazio di buffer (buffer e lunghezza del buffer trasmessi per riferimento). Il chiamante (applicazione utente) DOVREBBE utilizzare il buffer fornito, ma per motivi di compatibilità con le versioni precedenti potrebbe restituire il proprio buffer. Il chiamante non deve fornire più di aLength di byte. Al ritorno, aLength contiene il numero effettivo di byte letti nel buffer.

Consente di gestire il blocco di dati a cui punta un blocco aDataBlock di lunghezza aLength.

Probabilmente, dovrai scriverlo in un file e chiuderlo se isLastBlock è true.

Callback attivato quando un ReceiveInit inviato in precedenza è accettato dalla destinazione.

Ti consigliamo di sfruttare questa opportunità per aprire file o allocare risorse per il trasferimento, se non l'hai fatto quando lo hai avviato.

Callback richiamato quando si riceve un messaggio ReceiveInit.

Il suo compito è determinare se si desidera accettare il metodo di ricezione e, in questo caso, impostare aXfer->mIsAccepted=true in modo che il protocollo invii un messaggio di accettazione all'iniziatore. L'oggetto BDXTransfer viene avviato alle impostazioni predefinite. Qui è possibile collegare qualsiasi stato specifico dell'applicazione (handle di file aperti ecc.) a aXfer->mAppState. A questo punto dovresti anche collegare i gestori necessari per la gestione dei blocchi all'oggetto BDXTransfer. Se viene restituito un codice di errore diverso da kStatus_Success, il trasferimento verrà considerato rifiutato e il protocollo gestirà l'invio di un messaggio di rifiuto con il codice.

Richiamato se uno dei messaggi Init precedenti è stato rifiutato dalla destinazione.

Callback richiamato quando un SendInit inviato in precedenza è accettato dalla destinazione.

Ti consigliamo di sfruttare questa opportunità per aprire file o allocare risorse per il trasferimento, se non l'hai fatto quando lo hai avviato.

Callback richiamato alla ricezione di un messaggio SendInit.

Il suo compito è determinare se vuoi accettare SendInit e, in questo caso, impostare aXfer->mIsAccepted=true in modo che il protocollo invii un messaggio di accettazione all'iniziatore. L'oggetto BDXTransfer viene avviato alle impostazioni predefinite. Qui è possibile collegare qualsiasi stato specifico dell'applicazione (handle di file aperti ecc.) a aXfer->mAppState. A questo punto dovresti anche collegare i gestori necessari per la gestione dei blocchi all'oggetto BDXTransfer. Se viene restituito un codice di errore diverso da WEAVE_NO_ERROR, il trasferimento viene considerato rifiutato e il protocollo gestisce l'invio di un messaggio di rifiuto con il codice.

Gestisci le richieste in cui il trasferimento è terminato.

Gestire i messaggi TransferError ricevuti o inviati da BDX.

Nota: si presume che il trasferimento BDX sia potenzialmente recuperabile (possibilmente temporaneo, ad esempio PacketBuffers al momento), quindi l'opzione di chiamare Shutdown() viene lasciata al programmatore di applicazioni e ai callback da lui definiti. DA FARE: verificalo e riconcilialo con la lingua del documento BDX, che indica: "[Un errore di trasferimento] Può essere inviato in qualsiasi momento da una delle parti per terminare prematuramente il trasferimento di dati collettivo".

GetBDXAckFlag restituisce il flag appropriato per il campo RequestAck in base alla connessione del contesto dello scambio (nessuna ACK della richiesta per TCP) e in base al supporto del tempo di compilazione per WRMP.