Función HttpSendRequestExW (wininet.h)

  • Artículo

Envía la solicitud especificada al servidor HTTP.

Nota Los autores de llamadas que necesitan enviar datos adicionales más allá de lo que normalmente se pasa a HttpSendRequestEx pueden hacerlo llamando a HttpSendRequest en su lugar.
 

Sintaxis

BOOL HttpSendRequestExW(
  [in]  HINTERNET           hRequest,
  [in]  LPINTERNET_BUFFERSW lpBuffersIn,
  [out] LPINTERNET_BUFFERSW lpBuffersOut,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

Parámetros

[in] hRequest

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

[in] lpBuffersIn

Opcional. Puntero a una estructura de INTERNET_BUFFERS .

[out] lpBuffersOut

Reservado. Debe ser NULL.

[in] dwFlags

Reservado. Debe ser cero.

[in] dwContext

Valor de contexto definido por la aplicación, si se ha registrado una función de devolución de llamada de estado.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

HttpSendRequestEx realiza el envío y la recepción de la respuesta. Esto no permite que la aplicación envíe datos adicionales más allá del único búfer que se pasó a HttpSendRequestEx. Los autores de llamadas que necesitan enviar datos adicionales más allá de lo que normalmente se pasa a HttpSendRequestEx pueden hacerlo llamando a HttpSendRequest en su lugar. Después de la llamada a HttpSendRequestEx, envíe los datos restantes llamando a InternetWriteFile. Por último, realice un seguimiento con una llamada a HttpEndRequest.

Nota La función HttpSendRequestExA representa los datos que se van a enviar como caracteres ISO-8859-1 no como caracteres ANSI. La función HttpSendRequestExW representa los datos que se envían como caracteres ISO-8859-1 convertidos en caracteres UTF-16LE. Como resultado, nunca es seguro usar la función HttpSendRequestExW cuando los encabezados que se van a agregar pueden contener caracteres no ASCII. En su lugar, una aplicación puede usar las funciones MultiByteToWideChar y WideCharToMultiByte con un parámetro Codepage establecido en 28591 para asignar entre caracteres ANSI y caracteres UTF-16LE.
 
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 HttpSendRequestEx 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 Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wininet.h
Library Wininet.lib
Archivo DLL Wininet.dll

Consulte también

Sesiones HTTP

Funciones de WinINet