Click to return to the Networking, Protocols     
HttpAddRequestHeaders Fun...     HttpOpenRequest Function     HTTP Functions    
Web Workshop  |  Networking, Protocols & Data Formats

HttpEndRequest Function


Ends an HTTP request that was initiated by HttpSendRequestEx.

Syntax

BOOL HttpEndRequest(
    IN HINTERNET hRequest,
    OUT LPINTERNET_BUFFERS lpBuffersOut,
    IN DWORD dwFlags,
    IN DWORD dwContext
);

The actual syntax of this function varies between its ANSI and Unicode implementations. For more information, see Win32 Internet Functions Syntax.

Parameters

hRequest
HINTERNET handle returned by HttpOpenRequest and sent by HttpSendRequestEx.
lpBuffersOut
Reserved. Must be set to NULL.
Address of an INTERNET_BUFFERS structure.
dwFlags
Unsigned long integer value that contains the flags that control this function. Can be one of the following values:
HSR_ASYNC
Identical to WININET_API_FLAG_ASYNC.
HSR_SYNC
Identical to WININET_API_FLAG_SYNC.
HSR_USE_CONTEXT
Identical to WININET_API_FLAG_USE_CONTEXT.
HSR_INITIATE
Iterative operation (completed by HttpEndRequest).
HSR_DOWNLOAD
Download resource to file.
HSR_CHUNKED
Send chunked data.
dwContext
Unsigned long integer variable that contains the application-defined context value for applications that register a status callback function.

Return Value

Returns TRUE if successful, or FALSE otherwise. To get extended error information, call GetLastError.

Function Information

Windows NT Use version 4.0. Implemented as ANSI and Unicode functions.
Windows Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header Wininet.h
Import library Wininet.lib
Minimum availability Internet Explorer 4.0 (ANSI only), 5 (ANSI and Unicode)

Windows CE

Windows CE Use version 2.12 and later. Implemented as ANSI and Unicode functions.
Minimum availability Internet Explorer 4.0

See Also

Microsoft Win32 Internet Functions Overview, HTTP Sessions, Microsoft Win32 Internet Functions Reference, HTTP Functions



Back to topBack to top

Did you find this topic useful? Suggestions for other topics? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.