CHttpFile::QueryInfo

Artículo
02/19/2013

Llame a esta función miembro para devolver respuesta o encabezados de solicitud de una solicitud HTTP.

BOOL QueryInfo(
   DWORD dwInfoLevel,
   LPVOID lpvBuffer,
   LPDWORD lpdwBufferLength,
   LPDWORD lpdwIndex = NULL 
) const;
BOOL QueryInfo(
   DWORD dwInfoLevel,
   CString& str,
   LPDWORD dwIndex = NULL 
) const;
BOOL QueryInfo(
   DWORD dwInfoLevel,
   SYSTEMTIME* pSysTime,
   LPDWORD dwIndex = NULL 
) const;

Parámetros

dwInfoLevel
Una combinación de atributos de ver y las marcas siguientes que especifican el tipo de información solicitado:
- HTTP_QUERY_CUSTOM encuentra el nombre del encabezado y devuelve este valor en lpvBuffer en la salida.HTTP_QUERY_CUSTOM produce una aserción si el encabezado no se encuentra.
- HTTP_QUERY_FLAG_REQUEST_HEADERS Typically, la aplicación consulta los encabezados de respuesta, pero una aplicación puede consultar encabezados de solicitud mediante este marcador.
- HTTP_QUERY_FLAG_SYSTEMTIME For esos encabezados cuyo valor es una cadena de fecha y hora, como “Pasado-Modified- Tiempo,” retornos de este marcador el valor de encabezado como una estructura de Win32 SYSTEMTIME standard que no requiere la aplicación para analizar los datos.Si utiliza este marcador, se puede utilizar la invalidación de SYSTEMTIME de la función.
- HTTP_QUERY_FLAG_NUMBER For esos encabezados cuyo valor es un número, como el código de estado, retornos de esta marca los datos como un número de 32 bits.
Vea la sección de Comentarios para una lista de valores posibles.
lpvBuffer
Un puntero al búfer que recibe información.
lpdwBufferLength
En la entrada, estos puntos en un valor que contiene la longitud del búfer de datos, en número de caracteres o de bytes.Vea la sección de Comentarios para obtener información detallada sobre este parámetro.
lpdwIndex
Un puntero a un índice de base cero del encabezado.puede ser NULL.Utilice este marcador para mostrar varios encabezados con el mismo nombre.En la entrada, lpdwIndex indica el índice del encabezado especificado para devolver.En la salida, lpdwIndex indica el índice del encabezado siguiente.Si el índice siguiente no se encuentra, se devuelve ERROR_HTTP_HEADER_NOT_FOUND .
str
Una referencia al objeto de CString que recibe información devuelta.
dwIndex
un valor de índice.Vea lpdwIndex.
pSysTime
un puntero a una estructura de Win32 SYSTEMTIME .

Valor devuelto

Distinto de cero si correctamente; si no 0.Si se produce un error en la llamada, la función GetLastError de Win32 se puede llamar para determinar la causa del error.

Comentarios

Utilice esta función miembro sólo después de una llamada correcta a SendRequest o en un objeto de CHttpFile creado correctamente por OpenURL.

Puede recuperar los siguientes tipos de datos de QueryInfo:

cadenas (valor predeterminado)
SYSTEMTIME (para “datos: ” Expira: ” etc., encabezados)
DWORD (para STATUS_CODE, CONTENT_LENGTH, etc.).

Cuando una cadena se escribe en el búfer, y la función miembro tiene éxito, lpdwBufferLength contiene la longitud de la cadena en caracteres menos 1 por el carácter de NULL que finaliza.

Inclusión posible de los valores de dwInfoLevel :