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 .
HRESULT QueryHeader(
[in] LPCWSTR szHeaderName,
[in] DWORD dwIndex,
[out] LPWSTR *ppszHeaderValue
);
[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.
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 |
---|---|
|
Devolvió correctamente el valor del encabezado especificado con el índice especificado. |
|
No hay memoria suficiente para completar la operación. |
|
El parámetro ppszHeaderValue es un puntero no válido. |
|
El valor del parámetro dwIndex está fuera del intervalo. |
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 |