Função MprAdminRegisterConnectionNotification (mprapi.h)
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 |
---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
O Gerenciador de Discagem de Demanda (DDM) não está em execução. |
|
O parâmetro hEventNotification é NULL ou é um identificador inválido. |
|
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 |
Confira também
MprAdminDeregisterConnectionNotification