IBackgroundCopyJobHttpOptions::GetCustomHeaders-Methode (bits2_5.h)
Ruft die benutzerdefinierten Header ab, die durch einen früheren Aufruf von IBackgroundCopyJobHttpOptions::SetCustomHeaders festgelegt wurden (d. h. Header, die BITS an die Remotedatei sendet, nicht Header, die BITS von der Remote empfängt).
Syntax
HRESULT GetCustomHeaders(
[out] LPWSTR *pRequestHeaders
);
Parameter
[out] pRequestHeaders
Null-Zeichenfolge, die die benutzerdefinierten Header enthält. Jeder Header wird durch ein Wagenrücklauf- und Zeilenvorschubzeichen (CR/LF) beendet. Um die Zeichenfolge zu beenden, rufen Sie die CoTaskMemFree-Funktion auf.
Rückgabewert
In der folgenden Tabelle sind einige der möglichen Rückgabewerte aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Header wurden erfolgreich abgerufen. |
|
Der Auftrag gibt keine benutzerdefinierten Header an. |
|
Entweder verfügen Sie nicht über die Berechtigung zum Abrufen der benutzerdefinierten Header, oder [IBackgroundCopyJobHttpOptions3::MakeCustomHeadersWriteOnly](/windows/desktop/api/bits10_3/nf-bits10_3-ibackgroundcopyjobhttps3-makecustomheaderswriteonly) wurde für den Auftrag aufgerufen. |
|
Der pRequestHeaders-Parameter ist NULL. |
Hinweise
Nur der Auftragsbesitzer kann die benutzerdefinierten Header abrufen. Um die Header anzugeben, rufen Sie die IBackgroundCopyJobHttpOptions::SetCustomHeaders-Methode auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | bits2_5.h (Bits.h einschließen) |
| Bibliothek | Bits.lib |