Método IMFHttpDownloadRequest::QueryHeader (mfidl.h)

Invocado por Microsoft Media Foundation para recuperar los valores de los encabezados HTTP especificados de la respuesta a una solicitud HTTP o HTTPS enviada previamente. Media Foundation invoca este método solo después de haber invocado correctamente el método EndReceiveResponse .

Sintaxis

HRESULT QueryHeader(
  [in]  LPCWSTR szHeaderName,
  [in]  DWORD   dwIndex,
  [out] LPWSTR  *ppszHeaderValue
);

Parámetros

[in] szHeaderName

Nombre del encabezado HTTP para el que se consulta el valor.

[in] dwIndex

Número de índice del encabezado especificado, para el caso en el que la respuesta contiene varios encabezados con el mismo nombre. Un valor de 0 indica que se solicita el valor del primer encabezado con el nombre especificado, 1 indica que se solicita el segundo encabezado, etc.

[out] ppszHeaderValue

Se establece en el valor del encabezado solicitado, no incluidos los caracteres de retorno de carro o avance de línea. La memoria de ppszHeaderValue debe asignarse con CoTaskMemAlloc y media Foundation liberará con CoTaskMemFree.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	Devolvió correctamente el valor del encabezado especificado con el índice especificado.
E_OUTOFMEMORY	No hay memoria suficiente para completar la operación.
E_POINTER	El parámetro ppszHeaderValue es un puntero no válido.
MF_E_OUT_OF_RANGE	El valor del parámetro dwIndex está fuera del intervalo.

Requisitos

Cliente mínimo compatible	Windows 10, versión 1703 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mfplat.lib; Mfplat.dll

Consulte también

IMFHttpDownloadRequest