Fonction MprAdminConnectionGetInfoEx (mprapi.h)

Article
02/29/2024

La fonction MprAdminConnectionGetInfoEx récupère les informations de connexion d’une connexion spécifique sur un serveur RRAS spécifié.

Syntaxe

DWORD MprAdminConnectionGetInfoEx(
  [in]  RAS_SERVER_HANDLE  hRasServer,
  [in]  HANDLE             hRasConnection,
  [out] PRAS_CONNECTION_EX pRasConnection
);

Paramètres

[in] hRasServer

Handle vers l’ordinateur à partir duquel les informations de connexion sont récupérées. Pour obtenir ce handle, appelez MprAdminServerConnect.

[in] hRasConnection

Handle de la connexion pour récupérer des données. Pour obtenir ce handle, appelez MprAdminConnectionEnum.

[out] pRasConnection

Pointeur, en sortie, vers une structure RAS_CONNECTION_EX qui contient les informations de connexion pour le serveur RRAS dans hRasServer.

Pour libérer cette mémoire, appelez MprAdminBufferFree.

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_PROC_NOT_FOUND	La procédure spécifiée est introuvable.
Autres	Erreur de MprError.h, RasError.h ou WinError.h.

Remarques

L’appelant doit libérer la mémoire pointée par pRasConnection en appelant la fonction MprAdminBufferFree.

Configuration requise

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

Voir aussi

MprAdminBufferFree

MprAdminConnectionEnum

MprAdminConnectionGetInfo

Fonctions d’administration RAS

Informations de référence sur l’administration du service d’accès à distance

Partager via