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

Establezca en el valor del encabezado solicitado, sin incluir 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 de retorno

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

Requisitos

Consulte también

IMFHttpDownloadRequest