Méthode IBackgroundCopyJobHttpOptions ::GetCustomHeaders (bits2_5.h)

Récupère les en-têtes personnalisés définis par un appel précédent à IBackgroundCopyJobHttpOptions ::SetCustomHeaders (c’est-à-dire les en-têtes que BITS seront envoyés à la distante, et non les en-têtes que BITS reçoivent de la télécommande).

Syntaxe

HRESULT GetCustomHeaders(
  [out] LPWSTR *pRequestHeaders
);

Paramètres

[out] pRequestHeaders

Chaîne terminée par null qui contient les en-têtes personnalisés. Chaque en-tête est terminé par un caractère de retour chariot et de flux de ligne (CR/LF). Pour libérer la chaîne lorsque vous avez terminé, appelez la fonction CoTaskMemFree .

Valeur retournée

Le tableau suivant répertorie certaines des valeurs de retour possibles.

Code de retour	Description
S_OK	Récupération réussie des en-têtes.
S_FALSE	Le travail ne spécifie pas d’en-têtes personnalisés.
E_ACCESSDENIED	Soit vous n’avez pas l’autorisation de récupérer les en-têtes personnalisés, soit [IBackgroundCopyJobHttpOptions3 ::MakeCustomHeadersWriteOnly](/windows/desktop/api/bits10_3/nf-bits10_3-ibackgroundcopyjobhttpoptions3-makecustomheaderswriteonly) a été appelé sur le travail.
RPC_X_NULL_REF_POINTER	Le paramètre pRequestHeaders est NULL.

Remarques

Seul le propriétaire du travail peut récupérer les en-têtes personnalisés. Pour spécifier les en-têtes, appelez la méthode IBackgroundCopyJobHttpOptions ::SetCustomHeaders .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	bits2_5.h (include Bits.h)
Bibliothèque	Bits.lib

Voir aussi

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions ::SetCustomHeaders