Fonction MprAdminConnectionGetInfoEx (mprapi.h)

  • Article

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