IBackgroundCopyJobHttpOptions：：GetCustomHeaders 方法 (bits2_5.h)

检索先前调用 IBackgroundCopyJobHttpOptions：：SetCustomHeaders (设置的自定义标头，即 BITS 将发送到远程的标头，而不是 BITS 从远程) 接收的标头。

语法

HRESULT GetCustomHeaders(
  [out] LPWSTR *pRequestHeaders
);

[out] pRequestHeaders

包含自定义标头的以 Null 结尾的字符串。每个标头由回车符和换行符 (CR/LF) 字符终止。若要在完成后释放字符串，请调用 CoTaskMemFree 函数。

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

返回代码	说明
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 方法。