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 |
|---|---|
|
Récupération réussie des en-têtes. |
|
Le travail ne spécifie pas d’en-têtes personnalisés. |
|
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. |
|
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 |