Partager via

Méthode IBackgroundCopyJob2 ::GetReplyData (bits1_5.h)

  • Article

Récupère une copie en mémoire des données de réponse à partir de l’application serveur. Appelez cette méthode uniquement si le type du travail est BG_JOB_TYPE_UPLOAD_REPLY et que son état est BG_JOB_STATE_TRANSFERRED.

Syntaxe

HRESULT GetReplyData(
  [in, out] byte   **ppBuffer,
  [out]     UINT64 *pLength
);

Paramètres

[in, out] ppBuffer

Mémoire tampon pour contenir les données de réponse. La méthode définit ppBuffer sur NULL si l’application serveur n’a pas retourné de réponse. Appelez la fonction CoTaskMemFree pour libérer ppBuffer lorsque vous avez terminé.

[out] pLength

Taille, en octets, des données de réponse dans ppBuffer.

Valeur retournée

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Code de retour Description
S_OK
 Récupération réussie des données de réponse.
BG_E_TOO_LARGE
 Les données de réponse dépassent la taille maximale de la mémoire tampon de 1 Mo. Le paramètre ppBuffer a la valeur NULL et pSize contient la taille des données de réponse.
BG_E_INVALID_STATE
 Pour récupérer les données de réponse, l’état du travail doit être BG_JOB_STATE_TRANSFERRED.
E_NOTIMPL
 Cette méthode n’est pas implémentée pour les travaux de type BG_JOB_TYPE_DOWNLOAD ou BG_JOB_TYPE_UPLOAD.

Remarques

La méthode GetReplyData vous permet de lire les données de réponse avant ou après l’appel de la méthode IBackgroundCopyJob ::Complete . Toutefois, pour lire les données de réponse du fichier de réponse, vous devez d’abord appeler la méthode Complete ; le fichier n’est pas disponible pour le client tant que vous n’avez pas appelé la méthode Complete .

La méthode GetReplyData retourne BG_E_TOO_LARGE si les données de réponse dépassent 1 Mo (pSize contient la taille des données de réponse). Pour récupérer la réponse si elle dépasse 1 Mo, appelez la méthode IBackgroundCopyJob2 ::GetReplyFileName pour récupérer le nom du fichier. Ouvrez ensuite le fichier et lisez directement les données de réponse.

Exemples

Pour obtenir un exemple qui utilise la méthode GetReplyData , consultez Récupération de la réponse à partir d’un travail de Upload-Reply.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2003
Plateforme cible Windows
En-tête bits1_5.h (incluez Bits.h)
Bibliothèque Bits.lib
DLL BitsPrx2.dll
Composant redistribuable BITS 1.5 sur Windows XP

Voir aussi

IBackgroundCopyJob2 ::GetReplyFileName

IBackgroundCopyJob2 ::SetReplyFileName