Expand Minimize
1 out of 7 rated this helpful - Rate this topic

HttpSendRequestEx function

Sends the specified request to the HTTP server.

Note  Callers that need to send extra data beyond what is normally passed to HttpSendRequestEx can do so by calling HttpSendRequest instead.

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

HttpSendRequestEx 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 HttpSendRequestEx. Callers that need to send extra data beyond what is normally passed to HttpSendRequestEx can do so by calling HttpSendRequest 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 [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

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: 10/26/2012

Community Additions

ADD
© 2013 Microsoft. All rights reserved.