Función HttpSendRequestA (wininet.h)
Envía la solicitud especificada al servidor HTTP, lo que permite a los llamadores enviar datos adicionales más allá de lo que normalmente se pasa a HttpSendRequestEx.
Sintaxis
BOOL HttpSendRequestA(
[in] HINTERNET hRequest,
[in] LPCSTR lpszHeaders,
[in] DWORD dwHeadersLength,
[in] LPVOID lpOptional,
[in] DWORD dwOptionalLength
);
Parámetros
[in] hRequest
Identificador devuelto por una llamada a la función HttpOpenRequest .
[in] lpszHeaders
Puntero a una cadena terminada en null que contiene los encabezados adicionales que se van a anexar a la solicitud. Este parámetro puede ser NULL si no hay encabezados adicionales que se van a anexar.
[in] dwHeadersLength
Tamaño de los encabezados adicionales, en TCHAR. Si este parámetro es -1L y lpszHeaders no es NULL, la función asume que lpszHeaders está terminada en cero (ASCIIZ) y se calcula la longitud. Vea Comentarios para obtener información específica.
[in] lpOptional
Puntero a un búfer que contiene los datos opcionales que se enviarán inmediatamente después de los encabezados de solicitud. Este parámetro se usa generalmente para las operaciones POST y PUT. Los datos opcionales pueden ser el recurso o la información que se publica en el servidor. Este parámetro puede ser NULL si no hay datos opcionales que enviar.
[in] dwOptionalLength
Tamaño de los datos opcionales, en bytes. Este parámetro puede ser cero si no hay datos opcionales que enviar.
Valor devuelto
Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario. Para obtener información de error extendida, llame a GetLastError.
Comentarios
HttpSendRequest envía la solicitud especificada al servidor HTTP y permite al cliente especificar encabezados adicionales para enviar junto con la solicitud.
La función también permite al cliente especificar datos opcionales para enviar al servidor HTTP inmediatamente después de los encabezados de solicitud. Esta característica se usa generalmente para operaciones de "escritura", como PUT y POST.
Una vez enviada la solicitud, se leen el código de estado y los encabezados de respuesta del servidor HTTP. Estos encabezados se mantienen internamente y están disponibles para las aplicaciones cliente a través de la función HttpQueryInfo .
Una aplicación puede usar el mismo identificador de solicitud HTTP en varias llamadas a HttpSendRequest, pero la aplicación debe leer todos los datos devueltos de la llamada anterior antes de volver a llamar a la función.
En el modo sin conexión, HttpSendRequest devuelve ERROR_FILE_NOT_FOUND si el recurso no se encuentra en la memoria caché de Internet.
Hay dos versiones de HttpSendRequest: HttpSendRequestA (que se usa con compilaciones ANSI) y HttpSendRequestW (se usa con compilaciones Unicode). Si dwHeadersLength es -1L y lpszHeaders no es NULL, se producirá lo siguiente: Si se llama a HttpSendRequestA , la función asume que lpszHeaders está terminada en cero (ASCIIZ) y se calcula la longitud. Si se llama a HttpSendRequestW , se produce un error en la función con ERROR_INVALID_PARAMETER.
Nota
El encabezado wininet.h define HttpSendRequest 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 |