Méthode IBackgroundCopyJob2 ::GetReplyData (bits1_5.h)
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 |
|---|---|
|
Récupération réussie des données de réponse. |
|
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. |
|
Pour récupérer les données de réponse, l’état du travail doit être BG_JOB_STATE_TRANSFERRED. |
|
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 |