IBackgroundCopyJobHttpOptions::GetCustomHeaders 메서드(bits2_5.h)

IBackgroundCopyJobHttpOptions::SetCustomHeaders에 대한 이전 호출에 의해 설정된 사용자 지정 헤더를 검색합니다(즉, 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 메서드를 호출합니다.