nl::Weave::Profiles::BDX_Development

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

Wenn also ein Fehler innerhalb eines anderen Handlers auftritt, dessen Signatur den Rückgabetyp „void“ hat (z.B. als Antwort auf eine eingehende Weave-Nachricht oder sogar durch das Protokoll weitergeleitet), wird dieser Handler aufgerufen, damit der Nutzer bestimmen kann, ob die Übertragung wiederhergestellt und fortgesetzt werden kann oder ob er Herunterfahren() aufrufen soll. Ein Fehler kann auftreten, bevor ein BDXTransfer initialisiert wurde (z.B. bereits zu viele zugewiesene Übertragungsobjekte). In einem solchen Fall wird der besagte Fehler von Weave protokolliert und das Protokoll kümmert sich um die Bereinigung aller notwendigen Zustände, die von Weave zugewiesen wurden.

Get a block of data to be transmitted.

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

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

Dazu ist es wahrscheinlich erforderlich, dass die Datei in eine Datei geschrieben und diese Datei geschlossen wird, wenn isLastBlock wahr ist.

Callback, der aufgerufen wird, wenn ein zuvor gesendetes ReceiveInit-Element vom Ziel akzeptiert wird.

Sie können diese Möglichkeit nutzen, um Dateien zu öffnen oder Ressourcen für die Übertragung zuzuweisen, falls Sie dies beim Start der Übertragung noch nicht getan haben.

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

Seine Aufgabe ist es zu bestimmen, ob Sie den Empfang akzeptieren möchten, und legen Sie in diesem Fall aXfer->mIsAccepted=true fest, damit das Protokoll eine Annahmenachricht an den Initiator sendet. Das Objekt BDXTransfer wird auf die Standardeinstellungen zurückgesetzt. Hier können Sie anwendungsspezifischen Status (z. B. offene Datei-Handles usw.) gut an aXfer->mAppState anhängen. An dieser Stelle sollten Sie auch die erforderlichen Handler, z.B. für die Blockierbehandlung, an das Objekt BDXTransfer anhängen. Wenn ein anderer Fehlercode als kStatus_Success zurückgegeben wird, wird angenommen, dass die Übertragung abgelehnt wird. Das Protokoll sendet dann eine Ablehnungsnachricht mit dem Code.

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

Callback, der aufgerufen wird, wenn ein zuvor gesendetes SendInit-Element vom Ziel akzeptiert wird.

Sie können diese Möglichkeit nutzen, um Dateien zu öffnen oder Ressourcen für die Übertragung zuzuweisen, falls Sie dies beim Start der Übertragung noch nicht getan haben.

Callback, der beim Empfang einer SendInit-Nachricht ausgelöst wird.

Dessen Aufgabe besteht darin, festzulegen, ob Sie SendInit akzeptieren möchten, und legen Sie in diesem Fall aXfer->mIsAccepted=true fest, damit das Protokoll eine Annahmenachricht an den Initiator sendet. Das Objekt BDXTransfer wird auf die Standardeinstellungen zurückgesetzt. Hier können Sie anwendungsspezifischen Status (z. B. offene Datei-Handles usw.) gut an aXfer->mAppState anhängen. An dieser Stelle sollten Sie auch die erforderlichen Handler, z.B. für die Blockierbehandlung, an das Objekt BDXTransfer anhängen. Wenn ein anderer Fehlercode als WEAVE_NO_ERROR zurückgegeben wird, wird davon ausgegangen, dass die Übertragung abgelehnt wird. Das Protokoll sendet dann eine Ablehnungsnachricht mit dem Code.

Umgang mit Fällen, in denen die Übertragung abgeschlossen ist.

Behandelt von BDX empfangene oder gesendete TransferError-Nachrichten.

Hinweis: Es wird davon ausgegangen, dass die BDX-Übertragung wiederhergestellt werden kann (möglicherweise vorübergehend, z. B. weil PacketBuffers derzeit nicht verfügbar ist). Daher bleibt die Option zum Aufrufen von Herunterfahren() dem Anwendungsprogrammierer und den definierten Callbacks überlassen. TODO: Überprüfen und mit der Sprache im BDX-Dokument abgleichen, die lautet: „[A TransferError] Kann jederzeit von jeder Partei gesendet werden, um die Bulk-Datenübertragung vorzeitig zu beenden.“

GetBDXAckFlag gibt je nach Verbindung des Exchange-Kontexts (keine Anfragebestätigung bei TCP) und basierend auf der Unterstützung der Kompilierungszeit für WRMP das entsprechende Flag für das RequestAck-Feld zurück.