IBackgroundCopyJob2 ::GetReplyData, méthode (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.

Remarques

La méthode GetReplyData vous permet de lire les données de réponse avant ou après avoir appelé 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’appelez pas 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. Ensuite, ouvrez le fichier et lisez directement les données de réponse.

Examples

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

Spécifications

Voir aussi

IBackgroundCopyJob2 ::GetReplyFileName

IBackgroundCopyJob2 ::SetReplyFileName