Partilhar via


Função WinHttpRegisterProxyChangeNotification (winhttp.h)

Registra uma função de retorno de chamada que o WinHTTP chama quando as configurações de proxy efetivas são alteradas.

Sintaxe

WINHTTPAPI DWORD WinHttpRegisterProxyChangeNotification(
  ULONGLONG                                ullFlags,
  WINHTTP_PROXY_CHANGE_CALLBACK            pfnCallback,
  PVOID                                    pvContext,
  WINHTTP_PROXY_CHANGE_REGISTRATION_HANDLE *hRegistration
);

Parâmetros

ullFlags

Tipo: _In_ ULONGLONG

O sinalizador a ser passado para o retorno de chamada (por exemplo, WINHTTP_PROXY_NOTIFY_CHANGE).

pfnCallback

Tipo: _In_ WINHTTP_PROXY_CHANGE_CALLBACK

Um ponteiro para a função de retorno de chamada que deve ser chamada quando as configurações de proxy efetivas são alteradas.

pvContext

Tipo: _In_ PVOID

Um ponteiro para um objeto de contexto a ser passado para o retorno de chamada.

hRegistration

Tipo: _Out_ WINHTTP_PROXY_CHANGE_REGISTRATION_HANDLE*

Um identificador que identifica o registro da função de retorno de chamada. Para cancelar o registro, passe esse valor para WinHttpUnregisterProxyChangeNotification. WINHTTP_PROXY_CHANGE_REGISTRATION_HANDLE é equivalente a PVOID.

Retornar valor

Um DWORD que contém um código status indicando o resultado da operação. Os códigos a seguir podem ser retornados (a lista não é exaustiva).

Código Descrição
ERROR_SUCCESS A operação foi realizada com êxito.

Requisitos

Requisito Valor
Cabeçalho winhttp.h
Biblioteca Winhttp.lib
DLL Winhttp.dll