nl::Weave::Profiles::BDX_Development

Dieser Handler wird jedes Mal aufgerufen, wenn ein Weave-Fehler auftritt, der nicht direkt über Fehlercodes an den benutzerdefinierte Steuerungsablauf zurückgegeben werden kann.

Wenn also ein Fehler bei einem anderen Handler auftritt, dessen Signatur den Rückgabetyp "void" hat (z.B. als Antwort auf eine eingehende Weave-Nachricht oder sogar durch das Protokoll ausgelöst), wird dieser Handler aufgerufen, damit der Nutzer bestimmen kann, ob die Übertragung wiederhergestellt und fortgesetzt werden kann oder ob er Shutdown() aufrufen sollte. Es kann vorkommen, dass vor der Initialisierung von BDXTransfer ein Fehler auftritt (z.B. bereits zu viele zugewiesene Übertragungsobjekte). In einem solchen Fall wird der Fehler von Weave protokolliert und das Protokoll bereinigt alle erforderlichen Status, die es zugewiesen hat.

Get a block of data to be transmitted.

Der Aufrufer stellt den Pufferbereich bereit (Puffer und Länge des Zwischenspeichers, die durch einen Verweis übergeben werden). Der Aufgerufene (Nutzeranwendung) SOLLTEN den bereitgestellten Zwischenspeicher verwenden, kann jedoch aus Gründen der Abwärtskompatibilität einen eigenen Zwischenspeicher zurückgeben. Der Aufgerufene darf nicht mehr als aLength an Byte bereitstellen. Nach der Rückgabe enthält aLength die tatsächliche Anzahl der in den Zwischenspeicher gelesenen Byte.

Verarbeitet den Datenblock, auf den einDataBlock der Länge aLength verweist.

Dazu wird wahrscheinlich in eine Datei geschrieben und die Datei geschlossen, wenn isLastBlock auf „true“ gesetzt ist.

Callback, das aufgerufen wird, wenn eine zuvor gesendete ReceiveInit-Anfrage vom Ziel akzeptiert wird.

Sie können diese Gelegenheit nutzen, um Dateien zu öffnen oder Ressourcen für die Übertragung zuzuweisen, wenn Sie dies nicht bereits bei der Initiierung der Übertragung getan haben.

Callback, der beim Empfangen einer ReceiveInit-Nachricht aufgerufen wird.

Seine Aufgabe besteht darin, zu bestimmen, ob Sie die Empfangsbestätigung annehmen möchten. Wenn dies der Fall ist, stellen Sie aXfer->mIsAccepted=true ein, sodass das Protokoll eine Empfangsnachricht an den Initiator sendet. Das BDXTransfer-Objekt wird mit den Standardeinstellungen initiiert. Hier können Sie anwendungsspezifische Status wie Handles von offenen Dateien usw. an aXfer->mAppState anhängen. Sie sollten auch die erforderlichen Handler für an das BDXTransfer-Objekt übergeben. Wenn ein anderer Fehlercode als kStatus_Success zurückgegeben wird, wird davon ausgegangen, dass die Übertragung abgelehnt wurde. Das Protokoll sendet dann eine Ablehnungsnachricht mit dem Code.

Wird aufgerufen, wenn eine der vorherigen Init-Nachrichten vom Ziel abgelehnt wurde.

Callback, das aufgerufen wird, wenn eine zuvor gesendete SendInit vom Ziel akzeptiert wird.

Sie können diese Gelegenheit nutzen, um Dateien zu öffnen oder Ressourcen für die Übertragung zuzuweisen, wenn Sie dies nicht bereits beim Starten der Übertragung getan haben.

Callback, der beim Empfangen einer SendInit-Nachricht aufgerufen wird.

Seine Aufgabe besteht darin, zu bestimmen, ob Sie SendInit akzeptieren möchten. Ist dies der Fall, legen Sie „aXfer->mIsAccepted=true“ fest, damit das Protokoll eine Annahmenachricht an den Initiator sendet. Das BDXTransfer-Objekt wird mit den Standardeinstellungen initiiert. Hier können Sie anwendungsspezifische Status wie Handles von offenen Dateien usw. an aXfer->mAppState anhängen. Sie sollten auch die erforderlichen Handler für an das BDXTransfer-Objekt übergeben. Wenn ein anderer Fehlercode als WEAVE_NO_ERROR zurückgegeben wird, wird davon ausgegangen, dass die Übertragung abgelehnt wurde. Das Protokoll sendet dann eine Ablehnungsnachricht mit dem Code.

Verarbeiten Sie Fälle, in denen die Übertragung abgeschlossen ist.

Verarbeiten Sie TransferError-Nachrichten, die von BDX empfangen oder gesendet werden.

Hinweis:Es wird davon ausgegangen, dass die BDX-Übertragung potenziell wiederherstellbar ist (möglicherweise vorübergehend, z. B. aus PacketBuffers im Moment). Daher bleibt die Option, Shutdown() aufzurufen, dem Anwendungsprogrammierer und den von ihm definierten Callbacks überlassen. AUFGABE: Überprüfen und mit der Sprache im BDX-Dokument abgleichen, das lautet: „[A TransferError] Kann jederzeit von beiden Parteien vorzeitig gesendet werden beenden Sie die Bulk-Datenübertragung.“

GetBDXAckFlag gibt abhängig von der Verbindung des Austauschkontexts (keine Anforderungsbestätigung für TCP) und basierend auf der Unterstützung der Kompilierungszeit für WRMP das entsprechende Flag für das RequestAck-Feld zurück.