nl::Weave::Profiles::BDX_Development

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

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

Get a block of data to be transmitted.

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

Gestisci il blocco di dati a cui punta unDataBlock di lunghezza aLength.

Probabilmente questo comporterà la scrittura in un file e la chiusura del file stesso se isLastBlock è true.

Callback richiamato quando un elemento ReceiveInit inviato in precedenza viene accettato dalla destinazione.

Potresti voler sfruttare questa opportunità per aprire i file o allocare risorse per il trasferimento se non l'hai fatto quando lo hai avviato.

Callback richiamato alla ricezione di un messaggio ReceiveInit.

Il suo compito è stabilire se desideri accettare la ricezione e, in tal caso, impostare aXfer->mIsAccepted=true in modo che il protocollo invii un messaggio di accettazione all'iniziatore. L'oggetto BDXTransfer viene avviato con le impostazioni predefinite. È un buon posto per collegare qualsiasi stato specifico dell'applicazione (handle di file aperti e così via) ad aXfer->mAppState. Devi anche collegare i gestori necessari, ad esempio la gestione dei blocchi all'oggetto BDXTransfer a questo punto. Se viene restituito un codice di errore diverso da kStatus_Success, si presume che il trasferimento sia stato 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 elemento SendInit inviato in precedenza viene accettato dalla destinazione.

Potresti voler sfruttare questa opportunità per aprire i 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 desideri accettare SendInit e, in tal caso, impostare aXfer->mIsAccepted=true in modo che il protocollo invii un messaggio di accettazione all'iniziatore. L'oggetto BDXTransfer viene avviato con le impostazioni predefinite. È un buon posto per collegare qualsiasi stato specifico dell'applicazione (handle di file aperti e così via) ad aXfer->mAppState. Devi anche collegare i gestori necessari, ad esempio la gestione dei blocchi all'oggetto BDXTransfer a questo punto. Se viene restituito un codice di errore diverso da WEAVE_NO_ERROR, si presume che il trasferimento sia stato rifiutato e il protocollo gestirà l'invio di un messaggio di rifiuto con il codice.

Gestisci i casi 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 fuori da PacketBuffers al momento), quindi l'opzione di chiamare Shutdown() viene lasciata al programmatore dell'applicazione e ai callback che definiscono. DA FARE: verificalo e riconcilialo con la lingua del documento BDX, che afferma: "[Errore di trasferimento] Può essere inviato in qualsiasi momento da entrambe le parti per prematuramente terminare il trasferimento collettivo dei dati".

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