Função NotifyNetworkConnectivityHintChange (netioapi.h)

Registra uma função de retorno de chamada definida pelo aplicativo, a ser chamada quando o nível de conectividade de rede agregado e as dicas de custo forem alterados.

Sintaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API NotifyNetworkConnectivityHintChange(
  [in]  PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK Callback,
  [in]  PVOID                                      CallerContext,
  [in]  BOOLEAN                                    InitialNotification,
  [out] PHANDLE                                    NotificationHandle
);

Parâmetros

[in] Callback

Um ponteiro de função do tipo PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK, que aponta para a função de retorno de chamada definida pelo aplicativo. A função de retorno de chamada será invocada quando ocorrer uma alteração de custo ou nível de conectividade de rede.

[in] CallerContext

O contexto do chamador específico do usuário. Esse contexto será fornecido para a função de retorno de chamada.

[in] InitialNotification

True se uma notificação de inicialização deve ser fornecida, caso contrário false, .

[out] NotificationHandle

Um ponteiro para um HANDLE. A função define o valor como um identificador para o registro de notificação.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR. Caso contrário, um código de erro será retornado.

Comentários

Para cancelar o registro de notificações de alteração, chame a função CancelMibChangeNotify2 , passando o parâmetro NotificationHandle retornado por NotifyNetworkConnectivityHintChange.

Requisitos

Confira também

• PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK

• CancelMibChangeNotify2