Compartir a través de

Función HttpQueryInfoA (wininet.h)

  • Artículo

Recupera información de encabezado asociada a una solicitud HTTP.

Sintaxis

BOOL HttpQueryInfoA(
  [in]      HINTERNET hRequest,
  [in]      DWORD     dwInfoLevel,
  [in, out] LPVOID    lpBuffer,
  [in, out] LPDWORD   lpdwBufferLength,
  [in, out] LPDWORD   lpdwIndex
);

Parámetros

[in] hRequest

Identificador devuelto por una llamada a la función HttpOpenRequest o InternetOpenUrl.

[in] dwInfoLevel

Combinación de un atributo que se va a recuperar y marcas que modifican la solicitud. Para obtener una lista de los posibles valores de atributo y modificador, consulte Marcas de información de consulta.

[in, out] lpBuffer

Puntero a un búfer para recibir la información solicitada. Este parámetro no debe ser NULL.

[in, out] lpdwBufferLength

Puntero a una variable que contiene, en la entrada, el tamaño en bytes del búfer al que apunta lpvBuffer.

Cuando la función se devuelve correctamente, esta variable contiene el número de bytes de información escrita en el búfer. En el caso de una cadena, el recuento de bytes no incluye la terminación de la cadena carácter null.

Cuando la función
produce un error extendido con un código de error extendido de ERROR_INSUFFICIENT_BUFFER, la variable a la que apunta lpdwBufferLength contiene al salir del tamaño, en bytes, de un búfer lo suficientemente grande como para recibir la información solicitada. Después, la aplicación que realiza la llamada puede asignar un búfer de este tamaño o mayor y llamar a la función de nuevo.

[in, out] lpdwIndex

Puntero a un índice de encabezado basado en cero usado para enumerar varios encabezados con el mismo nombre. Al llamar a la función , este parámetro es el índice del encabezado especificado que se va a devolver. Cuando la función devuelve, este parámetro es el índice del encabezado siguiente. Si no se encuentra el siguiente índice, se devuelve ERROR_HTTP_HEADER_NOT_FOUND.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Puede recuperar los siguientes tipos de datos de httpQueryInfo:

  • Cadenas (valor predeterminado)
  • SYSTEMTIME (para fechas)
  • DWORD (para STATUS_CODE, CONTENT_LENGTH, etc., si se ha usado HTTP_QUERY_FLAG_NUMBER)

Si la aplicación requiere que los datos se devuelvan como un tipo de datos distinto de una cadena, debe incluir el modificador adecuado con el atributo pasado a dwInfoLevel.

La función HttpQueryInfo está disponible en Microsoft Internet Explorer 3.0 para caracteres ISO-8859-1 (función HttpQueryInfoA) y en Internet Explorer 4.10 o posterior para caracteres ISO-8859-1 (función HttpQueryInfoA) y para caracteres ISO-8859-1 convertidos a caracteres UTF-16LE. (la función HttpQueryInfoW).

Nota La función httpQueryInfoA representa encabezados como caracteres ISO-8859-1 que no son caracteres ANSI. La función HttpQueryInfoW representa encabezados como caracteres ISO-8859-1 convertidos a caracteres UTF-16LE. Como resultado, nunca es seguro usar la función HttpQueryInfoW cuando los encabezados pueden contener caracteres no ASCII. En su lugar, una aplicación puede usar el MultiByteToWideChar y funciones de WideCharToMultiByte con un parámetro Codepage establecido en 28591 para asignar entre caracteres ANSI y caracteres UTF-16LE.
 
Consulte Recuperación de encabezados HTTP para obtener un código de ejemplo que llame a la función httpQueryInfo de .

Al igual que todos los demás aspectos de la API de WinINet, esta función no se puede llamar de forma segura desde DllMain ni desde los constructores y destructores de objetos globales.

Nota WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use Servicios HTTP de Microsoft Windows (WinHTTP).
 

Nota

El encabezado wininet.h define HttpQueryInfo como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de wininet.h
biblioteca de Wininet.lib
DLL de Wininet.dll

Consulte también

sesiones HTTP

recuperar encabezados HTTP

funciones winINet