IBackgroundCopyJobHttpOptions：：GetCustomHeaders 方法 (bits2_5.h)

擷取先前呼叫 IBackgroundCopyJobHttpOptions：：SetCustomHeaders (所設定的自定義標頭，也就是 BITS 將傳送至遠端的標頭，而不是 BITS 從遠端) 接收的標頭。

語法

HRESULT GetCustomHeaders(
  [out] LPWSTR *pRequestHeaders
);

[out] pRequestHeaders

包含自訂標頭的 Null 終止字串。每個標頭都會以歸位字元和換行字元 (CR/LF) 字元終止。若要在完成時釋放字串，請呼叫 CoTaskMemFree 函式。

下表列出一些可能的傳回值。

傳回碼	Description
S_OK	已成功擷取標頭。
S_FALSE	作業未指定自定義標頭。
E_ACCESSDENIED	您沒有擷取自定義標頭的許可權，或 [IBackgroundCopyJobHttpOptions3：：MakeCustomHeadersWriteOnly] (/windows/desktop/api/bits10_3/nf-bits10_3-ibackgroundcopyjobHTTPoptions3-makecustomheaderswriteonly) 已在作業上呼叫。
RPC_X_NULL_REF_POINTER	pRequestHeaders 參數為 NULL。

只有作業擁有者可以擷取自定義標頭。若要指定標頭，請呼叫 IBackgroundCopyJobHttpOptions：：SetCustomHeaders 方法。