Partager via


IBackgroundCopyJobHttpOptions ::GetCustomHeaders, méthode (bits2_5.h)

Récupère les en-têtes personnalisés définis par un appel précédent à IBackgroundCopyJobHttpOptions ::SetCustomHeaders (autrement dit, les en-têtes que BITS envoient à distance, et non les en-têtes reçus par BITS à partir de la distance).

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 arrêté par un retour chariot et un caractère 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 Descriptif
S_OK
Récupère correctement les en-têtes.
S_FALSE
Le travail ne spécifie pas d’en-têtes personnalisés.
E_ACCESSDENIED
Vous n’êtes pas autorisé à récupérer les en-têtes personnalisés ou [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 .

Spécifications

Requirement Valeur
Client minimum requis Windows Vista
Serveur minimal pris en charge Windows Server 2008
plateforme cible Fenêtres
Header bits2_5.h (include Bits.h)
Library Bits.lib

Voir aussi

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions ::SetCustomHeaders