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.

Requisitos

Consulte también

IMFHttpDownloadRequest