RasAdminGetUserAccountServer fonction)
[Cette fonction est fournie uniquement pour la compatibilité descendante avec Windows NT Server 4,0. elle retourne un _ appel _ d’erreur non _ implémenté sur Windows Server 2003. Les applications doivent utiliser la fonction MprAdminGetPDCServer .]
La fonction RasAdminGetUserAccountServer récupère le nom du serveur qui contient la base de données de comptes d’utilisateur. Utilisez le nom de serveur renvoyé dans les fonctions RasAdminUserGetInfo et RasAdminUserSetInfo pour obtenir ou définir des informations sur un utilisateur spécifié.
Syntaxe
DWORD RasAdminGetUserAccountServer(
_In_ const WCHAR *lpszDomain,
_In_ const WCHAR *lpszServer,
_Out_ LPWSTR lpszUserAccountServer
);
Paramètres
-
lpszDomain [ dans]
-
Pointeur vers une chaîne Unicode terminée par le caractère null qui spécifie le nom du domaine auquel le serveur RAS appartient. Ce paramètre a la valeur null pour les applications d’administration RAS qui s’exécutent sur des stations de travail ou des serveurs qui ne sont pas membres d’un domaine. Si ce paramètre a la valeur null, le paramètre lpszServer doit être non null.
-
lpszServer [ dans]
-
Pointeur vers une chaîne Unicode terminée par le caractère null qui spécifie le nom du serveur RAS. Spécifiez le nom avec les \ \ caractères «» de début, sous la forme : \ \ NomServeur. Ce paramètre peut avoir la valeur null si le paramètre lpszDomain n’a pas la valeur null.
-
lpszUserAccountServer [ à]
-
Pointeur vers une mémoire tampon qui reçoit une chaîne Unicode terminée par le caractère null qui spécifie le nom d’un contrôleur de domaine qui possède la base de données de compte d’utilisateur. La mémoire tampon doit être suffisamment grande pour contenir le nom du serveur (ONCLEn + 1). La fonction préfixe le nom du serveur retourné avec les \ \ caractères «» de début, sous la forme : \ \ ServerName.
Valeur retournée
Si la fonction réussit, la valeur de retour est une erreur de _ réussite.
Si la fonction échoue, la valeur de retour peut être le code d’erreur suivant.
| Valeur | Signification |
|---|---|
|
LpszDomain et lpszServer sont tous deux null. |
Il n’y a pas d’informations d’erreur étendues pour cette fonction. ne pas appeler GetLastError.
Remarques
La fonction RasAdminGetUserAccountServer obtient le nom du serveur avec la base de données des comptes d’utilisateur. Cette fonction requiert le nom du serveur RAS ou le nom du domaine dans lequel réside le serveur RAS.
Le paramètre lpszDomain doit spécifier un nom de domaine valide. Ce paramètre a la valeur null pour les applications d’administration RAS s’exécutant sur des serveurs qui ne sont pas membres d’un domaine (par exemple, le serveur est dans son propre groupe de travail). Dans ce cas, le paramètre lpszServer doit spécifier le nom du serveur. Pour récupérer le nom du serveur, appelez la fonction GetComputerName . Veillez à faire précéder le nom du serveur de \ \ caractères «».
Si le nom du serveur spécifié par lpszServer est un serveur autonome (autrement dit, si le serveur ou la station de travail n’est pas membre d’un domaine), le nom du serveur lui-même est retourné dans la mémoire tampon lpszUserAccountServer .
Utilisez ensuite le nom du serveur de compte d’utilisateur dans un appel à la fonction NetQueryDisplayInformation pour énumérer les utilisateurs de la base de données des comptes d’utilisateur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge des clients |
Windows 2000 Professionnel |
| Fin de la prise en charge des serveurs |
Windows 2000 Server |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|