Share via

IBackgroundCopyJobHttpOptions::GetCustomHeaders-Methode (bits2_5.h)

  • Artikel

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
S_OK
 Die Header wurden erfolgreich abgerufen.
S_FALSE
 Der Auftrag gibt keine benutzerdefinierten Header an.
E_ACCESSDENIED
 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.
RPC_X_NULL_REF_POINTER
 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

Weitere Informationen

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetCustomHeaders