Compartir a través de


Función MprAdminRegisterConnectionNotification (mprapi.h)

La función MprAdminRegisterConnectionNotification registra un objeto de evento con el Administrador de marcado a petición (DDM) para que, si una interfaz se conecta o se desconecta, se señala el evento.

Sintaxis

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

Parámetros

[in] hMprServer

Controle al enrutador en el que se va a ejecutar esta llamada. Obtenga este identificador llamando a MprAdminServerConnect.

[in] hEventNotification

Identificador de un objeto de evento. Este evento se señala cada vez que una interfaz se conecta o se desconecta.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto se NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_ACCESS_DENIED
La aplicación que realiza la llamada no tiene privilegios suficientes.
ERROR_DDM_NOT_RUNNING
El Administrador de marcado a petición (DDM) no se está ejecutando.
ERROR_INVALID_PARAMETER
El parámetro hEventNotification es NULL o es un identificador no válido.
Otros
Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.
 
 

Comentarios

El evento se señala cuando una interfaz se conecta o se desconecta. Cuando se señala un evento, la aplicación que realiza la llamada puede determinar qué interfaz se ve afectada mediante una función como MprAdminConnectionEnum o MprAdminInterfaceEnum.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mprapi.h
Library Mprapi.lib
Archivo DLL Mprapi.dll

Consulte también

FormatMessage

MprAdminConnectionEnum

MprAdminDeregisterConnectionNotification

MprAdminInterfaceEnum

Funciones de administración del enrutador

Referencia de administración de enrutadores