Função MprAdminRegisterConnectionNotification (mprapi.h)

Artigo
02/29/2024

A função MprAdminRegisterConnectionNotification registra um objeto de evento com o Gerenciador de Discagem de Demanda (DDM) para que, se uma interface se conectar ou desconectar, o evento seja sinalizado.

Sintaxe

DWORD MprAdminRegisterConnectionNotification(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hEventNotification
);

Parâmetros

[in] hMprServer

Manipule para o roteador no qual executar essa chamada. Obtenha esse identificador chamando MprAdminServerConnect.

[in] hEventNotification

Identificador para um objeto de evento. Esse evento é sinalizado sempre que uma interface se conecta ou se desconecta.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Valor	Significado
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
ERROR_DDM_NOT_RUNNING	O Gerenciador de Discagem de Demanda (DDM) não está em execução.
ERROR_INVALID_PARAMETER	O parâmetro hEventNotification é NULL ou é um identificador inválido.
Outros	Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Comentários

O evento é sinalizado quando uma interface se conecta ou se desconecta. Quando um evento é sinalizado, o aplicativo de chamada pode determinar qual interface é afetada usando uma função como MprAdminConnectionEnum ou MprAdminInterfaceEnum.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h
Biblioteca	Mprapi.lib
DLL	Mprapi.dll