取得先前呼叫 IBackgroundCopyJobHttpOptions::SetCustomHeaders 所設定的自訂標頭(即 BITS 將傳送給遠端的標頭,而非 BITS 從遠端接收的標頭)。
語法
HRESULT GetCustomHeaders(
[out] LPWSTR *pRequestHeaders
);
參數
[out] pRequestHeaders
包含自訂標頭的 null 終止字串。 每個標頭以回車與換行(CR/LF)字元結尾。 完成後要釋放字串,呼叫 CoTaskMemFree 函式。
返回值
下表列出了一些可能的回傳值。
| 回傳碼 | Description |
|---|---|
|
成功取得標頭。 |
|
該工作並未指定自訂標頭。 |
|
要麼你沒有權限取得自訂標頭,要麼是 [IBackgroundCopyJobHttpOptions3::MakeCustomHeadersWriteOnly](/windows/desktop/api/bits10_3/nf-bits10_3-ibackgroundcopyjobhttpoptions3-makecustomheaderswriteonly) |
|
pRequestHeaders 參數為 NULL。 |
備註
只有工作擁有者能取得自訂標頭。 要指定標頭,請呼叫 IBackgroundCopyJobHttpOptions::SetCustomHeaders 方法。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 支援的最低伺服器 | Windows 伺服器 2008 |
| 目標平臺 | 窗戶 |
| Header | bits2_5.h(包含 Bits.h) |
| Library | Bits.lib |