Compartir a través de

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

  • Artículo

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