Método IBackgroundCopyJobHttpOptions::GetCustomHeaders (bits2_5.h)

Recupera los encabezados personalizados establecidos por una llamada anterior a IBackgroundCopyJobHttpOptions::SetCustomHeaders (es decir, los encabezados que BITS enviarán al remoto, no los encabezados que BITS recibe del remoto).

Sintaxis

HRESULT GetCustomHeaders(
  [out] LPWSTR *pRequestHeaders
);

Parámetros

[out] pRequestHeaders

Cadena terminada en NULL que contiene los encabezados personalizados. Cada encabezado finaliza con un carácter de retorno de carro y avance de línea (CR/LF). Para liberar la cadena cuando termine, llame a la función CoTaskMemFree .

Valor devuelto

En la tabla siguiente se enumeran algunos de los posibles valores devueltos.

Código devuelto	Descripción
S_OK	Recuperó correctamente los encabezados.
S_FALSE	El trabajo no especifica encabezados personalizados.
E_ACCESSDENIED	No tiene permiso para recuperar los encabezados personalizados o se ha llamado a [IBackgroundCopyJobHttpOptions3::MakeCustomHeadersWriteOnly](/windows/desktop/api/bits10_3/nf-bits10_3-ibackgroundcopyjobhttpoptions3-makecustomheaderswriteonly) en el trabajo.
RPC_X_NULL_REF_POINTER	El parámetro pRequestHeaders es NULL.

Comentarios

Solo el propietario del trabajo puede recuperar los encabezados personalizados. Para especificar los encabezados, llame al método IBackgroundCopyJobHttpOptions::SetCustomHeaders .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	bits2_5.h (incluir Bits.h)
Library	Bits.lib

Consulte también

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetCustomHeaders