nl::Weave::Profiles::BDX_Development

Ce gestionnaire est appelé chaque fois qu'une erreur Weave se produit et qu'elle ne peut pas être renvoyée directement via des codes d'erreur au flux de contrôle défini par l'application par l'utilisateur.

En d'autres termes, si une erreur se produit au sein d'un autre gestionnaire dont le type de signature est "void" (par exemple, en réponse à un message Weave entrant ou même envoyé par le protocole), ce gestionnaire est appelé afin que l'utilisateur puisse déterminer si le transfert peut être récupéré et continuer ou s'il doit appeler Shutdown(). Notez qu'une erreur peut se produire avant l'initialisation d'un transfert BDXTransfer (par exemple, trop d'objets de transfert alloués). Dans ce cas, cette erreur sera consignée par Weave, et le protocole se chargera de nettoyer tout état nécessaire alloué.

Get a block of data to be transmitted.

L'appelant fournit l'espace de mise en mémoire tampon (tampon et longueur du tampon, transmis par référence). L'appelé (application utilisateur) DOIT utiliser le tampon fourni, mais pour des raisons de rétrocompatibilité, il peut renvoyer son propre tampon. L'appelé ne doit pas fournir plus de aLength d'octets. En retour, aLength contient le nombre réel d'octets lus dans le tampon.

Gérer le bloc de données vers lequel pointe un DataBlock d'une longueur.

Cela impliquera probablement de l'écrire dans un fichier et de le fermer si isLastBlock est vrai.

Rappel invoqué lorsqu'un élément ReceiveInit précédemment envoyé est accepté par la destination.

Vous pouvez profiter de cette opportunité pour ouvrir des fichiers ou allouer des ressources pour le transfert si vous ne l'avez pas déjà fait lors de son lancement.

Rappel invoqué lors de la réception d'un message ReceiveInit.

Son rôle est de déterminer si vous souhaitez accepter la réception et, le cas échéant, de définir aXfer->mIsAccept=true afin que le protocole envoie un message d'acceptation à l'initiateur. L'objet BDXTransfer est lancé avec les paramètres par défaut. C'est l'endroit idéal pour associer n'importe quel état spécifique à une application (poignées de fichiers ouverts, etc.) à aXfer->mAppState. Vous devez également associer les gestionnaires nécessaires pour, par exemple, à l'objet BDXTransfer. Si un code d'erreur autre que kStatus_Success est renvoyé, le transfert est considéré comme rejeté et le protocole gère l'envoi d'un message de rejet avec ce code.

Appelée si l'un des messages Init précédents a été rejeté par la destination.

Rappel invoqué lorsqu'un élément SendInit précédemment envoyé est accepté par la destination.

Vous pouvez profiter de cette opportunité pour ouvrir des fichiers ou allouer des ressources pour le transfert si vous ne l'avez pas déjà fait lors de son lancement.

Rappel invoqué lors de la réception d'un message SendInit.

Son rôle est de déterminer si vous souhaitez accepter SendInit et, le cas échéant, de définir aXfer->mIsAccepted=true afin que le protocole envoie un message d'acceptation à l'initiateur. L'objet BDXTransfer est lancé avec les paramètres par défaut. C'est l'endroit idéal pour associer n'importe quel état spécifique à une application (poignées de fichiers ouverts, etc.) à aXfer->mAppState. Vous devez également associer les gestionnaires nécessaires pour, par exemple, la gestion des blocs à l'objet BDXTransfer. Si un code d'erreur autre que WEAVE_NO_ERROR est renvoyé, le transfert est considéré comme rejeté et le protocole gère l'envoi d'un message de rejet avec ce code.

Gérez les cas où le transfert est terminé.

Traitez les messages TransferError reçus ou envoyés par BDX.

Remarque:Le transfert BDX est supposé être potentiellement récupérable (peut-être temporaire, par exemple à partir de PacketBuffers pour le moment). L'option d'appel de Shutdown() est donc laissée au programmeur de l'application et aux rappels qu'il définit. À FAIRE: vérifier et rapprocher la langue du document BDX, qui indique : "[Une erreur de transfert] peut être envoyée à tout moment par l'une ou l'autre des parties pour prématurément mettre fin au transfert groupé de données. »

GetBDXAckFlag renvoie l'indicateur approprié pour le champ RequestAck en fonction de la connexion du contexte de l'échange (pas de confirmation de requête pour TCP) et de la compatibilité au moment de la compilation pour WRMP.