Funzione MprAdminRegisterConnectionNotification (mprapi.h)

Articolo
03/15/2023

La funzione MprAdminRegisterConnectionNotification registra un oggetto evento con Demand Dial Manager (DDM) in modo che, se un'interfaccia si connette o si disconnette, l'evento viene segnalato.

Sintassi

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

Parametri

[in] hMprServer

Gestire il router su cui eseguire questa chiamata. Ottenere questo handle chiamando MprAdminServerConnect.

[in] hEventNotification

Handle per un oggetto evento. Questo evento viene segnalato ogni volta che un'interfaccia si connette o si disconnette.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_DDM_NOT_RUNNING	Demand Dial Manager (DDM) non è in esecuzione.
ERROR_INVALID_PARAMETER	Il parametro hEventNotification è NULL o è un handle non valido.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

L'evento viene segnalato quando un'interfaccia si connette o si disconnette. Quando viene segnalato un evento, l'applicazione chiamante può determinare quale interfaccia è interessata tramite una funzione come MprAdminConnectionEnum o MprAdminInterfaceEnum.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll