Función HttpSendRequestExW (wininet.h)

Envía la solicitud especificada al servidor HTTP.

Nota llamadores que necesitan enviar datos adicionales más allá de lo que normalmente se pasa a HttpSendRequestEx puede hacerlo llamando a HttpSendRequest.

 

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 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.

Observaciones

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 búfer único 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, siga con una llamada a HttpEndRequest.

Nota La función HttpSendRequestExA representa los datos que se envían como caracteres ISO-8859-1 que no son caracteres ANSI. La función HttpSendRequestExW representa los datos que se envían como caracteres ISO-8859-1 convertidos a caracteres UTF-16LE. Como resultado, nunca es seguro usar el función HttpSendRequestExW cuando los encabezados que se van a agregar 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.

 

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 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

funciones winINet