共用方式為


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 方法。

需求

Requirement 價值觀
最低支援的用戶端 Windows Vista
支援的最低伺服器 Windows 伺服器 2008
目標平臺 窗戶
Header bits2_5.h(包含 Bits.h)
Library Bits.lib

另請參閱

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetCustomHeaders