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).

Requirements