Fonction MprAdminRegisterConnectionNotification (mprapi.h)

Article
03/04/2024

La fonction MprAdminRegisterConnectionNotification inscrit un objet d’événement auprès du Gestionnaire de numérotation de demande (DDM) afin que, si une interface se connecte ou se déconnecte, l’événement soit signalé.

Syntaxe

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

Paramètres

[in] hMprServer

Gérez le routeur sur lequel exécuter cet appel. Obtenez ce handle en appelant MprAdminServerConnect.

[in] hEventNotification

Gérez un objet d’événement. Cet événement est signalé chaque fois qu’une interface se connecte ou se déconnecte.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_ACCESS_DENIED	L’application appelante ne dispose pas de privilèges suffisants.
ERROR_DDM_NOT_RUNNING	Le Gestionnaire de numérotation de la demande (DDM) n’est pas en cours d’exécution.
ERROR_INVALID_PARAMETER	Le paramètre hEventNotification a la valeur NULL ou est un handle non valide.
Autres	Utilisez FormatMessage pour récupérer le message d’erreur système qui correspond au code d’erreur retourné.

Remarques

L’événement est signalé lorsqu’une interface se connecte ou se déconnecte. Lorsqu’un événement est signalé, l’application appelante peut déterminer quelle interface est affectée à l’aide d’une fonction telle que MprAdminConnectionEnum ou MprAdminInterfaceEnum.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mprapi.h
Bibliothèque	Mprapi.lib
DLL	Mprapi.dll