1 out of 7 rated this helpful - Rate this topic

HttpSendRequestEx function

Applies to: desktop apps only

Sends the specified request to the HTTP server.

Syntax

BOOL HttpSendRequestEx(
  __in   HINTERNET hRequest,
  __in   LPINTERNET_BUFFERS lpBuffersIn,
  __out  LPINTERNET_BUFFERS lpBuffersOut,
  __in   DWORD dwFlags,
  __in   DWORD_PTR dwContext
);

Parameters

hRequest [in]

The handle returned by HttpOpenRequest.

lpBuffersIn [in]

Optional. A pointer to an INTERNET_BUFFERS structure.

lpBuffersOut [out]

Reserved. Must be NULL.

dwFlags [in]

Reserved. Must be zero.

dwContext [in]

Application-defined context value, if a status callback function has been registered.

Return value

If the function succeeds, the function returns TRUE.

If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Remarks

HttpSendRequest performs both the send and the receive for the response. This does not allow the application to send any extra data beyond the single buffer that was passed to HttpSendRequest. Callers that need to send extra data beyond what is normally passed to HttpSendRequest can do so by calling HttpSendRequestEx instead. After the call to HttpSendRequestEx, send the remaining data by calling InternetWriteFile. Finally, follow up with a call to HttpEndRequest.

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Library

Wininet.lib

DLL

Wininet.dll

Unicode and ANSI names

HttpSendRequestExW (Unicode) and HttpSendRequestExA (ANSI)

See also

HTTP Sessions
WinINet Functions

 

 

Send comments about this topic to Microsoft

Build date: 2/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ