xcurl_global_suspend

Article
11/09/2023

Terminates active web requests, and prevents new requests from being sent.

Syntax

void xcurl_global_suspend(
)

Parameters

None.

Return value

None.

Remarks

Caution

As of the April 2021 GDK, suspend and resume is now automatically handled internally within XCurl. This function is still safe to call, but it is a no-op. The below remarks apply only to versions of the GDK before the April 2021 GDK.

This function aborts all HTTP requests from easy handles, and it prevents you from sending new HTTP requests.

To resume sending HTTP requests once again, call the function xcurl_global_resume.

Just as with WinHttp, you must clean up networking and HTTP handles upon receiving a suspend event.

Requirements

Header: XCurl.h

Library: xcurl.lib

Supported platforms: Windows, Xbox One family consoles and Xbox Series consoles