WinHttpRegisterProxyChangeNotification function (winhttp.h)
Registers a callback function that WinHTTP calls when the effective proxy settings change.
Syntax
WINHTTPAPI DWORD WinHttpRegisterProxyChangeNotification(
ULONGLONG ullFlags,
WINHTTP_PROXY_CHANGE_CALLBACK pfnCallback,
PVOID pvContext,
WINHTTP_PROXY_CHANGE_REGISTRATION_HANDLE *hRegistration
);
Parameters
ullFlags
Type: _In_ ULONGLONG
The flag to pass to the callback (for example, WINHTTP_PROXY_NOTIFY_CHANGE).
pfnCallback
Type: _In_ WINHTTP_PROXY_CHANGE_CALLBACK
A pointer to the callback function that should be called when the effective proxy settings change.
pvContext
Type: _In_ PVOID
A pointer to a context object to pass to the callback.
hRegistration
Type: _Out_ WINHTTP_PROXY_CHANGE_REGISTRATION_HANDLE*
A handle that identifies the registration of the callback function. To unregister, pass this value to WinHttpUnregisterProxyChangeNotification. WINHTTP_PROXY_CHANGE_REGISTRATION_HANDLE is equivalent to PVOID.
Return value
A DWORD containing a status code indicating the result of the operation. The following codes can be returned (the list is not exhaustive).
Code | Description |
---|---|
ERROR_SUCCESS | The operation succeeded. |
Requirements
Requirement | Value |
---|---|
Header | winhttp.h |
Library | Winhttp.lib |
DLL | Winhttp.dll |