MprAdminUserGetInfo, fonction (mprapi.h)

Article
08/24/2023

La fonction MprAdminUserGetInfo récupère toutes les informations RAS pour un utilisateur particulier.

Syntaxe

DWORD MprAdminUserGetInfo(
  [in]  LPCWSTR lpszServer,
  [in]  LPCWSTR lpszUser,
  [in]  DWORD   dwLevel,
  [out] LPBYTE  lpbBuffer
);

Paramètres

[in] lpszServer

Pointeur vers une chaîne Unicode qui spécifie le nom du serveur avec le master User Accounts Subsystem (UAS). Si le serveur d’accès à distance fait partie d’un domaine, l’ordinateur avec uaS est le contrôleur de domaine principal ou le contrôleur de domaine de sauvegarde. Si le serveur d’accès à distance ne fait pas partie d’un domaine, le serveur lui-même stocke l’UAS. Dans les deux cas, appelez la fonction MprAdminGetPDCServer pour obtenir la valeur de ce paramètre.

Si le serveur stocke lui-même l’UAS, ce paramètre peut être NULL.

[in] lpszUser

Pointeur vers une chaîne Unicode qui spécifie le nom de l’utilisateur pour lequel obtenir des informations RAS.

[in] dwLevel

Ce paramètre peut être égal à zéro ou à un.

Windows NT Server 4.0 avec SP3 et versions ultérieures : Ce paramètre doit être égal à zéro.

[out] lpbBuffer

Pointeur vers une structure RAS_USER_0 ou RAS_USER_1 . L’appelant doit allouer (et libérer) la mémoire pour cette structure. En cas de retour réussi, cette structure contient les données RAS de l’utilisateur spécifié.

Windows NT Server 4.0 avec SP3 et versions ultérieures : Si le paramètre dwLevel spécifie zéro, lpbBuffer doit pointer vers une structure RAS_USER_0 .

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’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	L’appelant ne dispose pas de privilèges suffisants.
ERROR_INVALID_LEVEL	La valeur de dwLevel n’est pas valide.
ERROR_INVALID_PARAMETER	lpbBuffer a la valeur NULL
ERROR_NO_SUCH_USER	L’utilisateur spécifié par lpwsUserName n’existe pas sur le serveur spécifié par lpwsServerName.

Remarques

Cette fonction est disponible sur Windows NT 4.0 si le redistribuable RRAS est installé. Toutefois, la version de Mprapi.dll fournie avec le redistribuable RRAS exporte la fonction en tant que RasAdminUserGetInfo plutôt que MprAdminUserGetInfo. Par conséquent, lorsque vous utilisez le redistribuable RRAS, utilisez LoadLibrary et GetProcAddress pour accéder à cette fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
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