Fonction RasAdminGetUserAccountServer

[Cette fonction est fournie uniquement pour la compatibilité descendante avec Windows NT Server 4.0. Il retourne ERROR_CALL_NOT_IMPLEMENTED sur Windows Server 2003. Les applications doivent utiliser la fonction MprAdminGetPDCServer .]

La fonction RasAdminGetUserAccountServer récupère le nom du serveur qui possède la base de données de compte d’utilisateur. Utilisez le nom de serveur retourné 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 [in]

Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du domaine auquel appartient le serveur RAS. Ce paramètre a la valeur NULL pour les applications d’administration RAS s’exécutant 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 [in]

Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du serveur RAS. Spécifiez le nom avec les caractères « \\ », sous la forme : \\servername. Ce paramètre peut avoir la valeur NULL si le paramètre lpszDomain n’est pas NULL.

lpszUserAccountServer [out]

Pointeur vers une mémoire tampon qui reçoit une chaîne Unicode terminée par null qui spécifie le nom d’un contrôleur de domaine qui a la base de données de compte d’utilisateur. La mémoire tampon doit être suffisamment grande pour contenir le nom du serveur (UNCLEN +1). La fonction préfixe le nom du serveur retourné avec les caractères « \\ » en tête, sous la forme : \\nom_serveur.

Valeur retournée

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

Si la fonction échoue, la valeur de retour peut être le code d’erreur suivant.

Valeur	Signification
ERROR_INVALID_PARAMETER	LpszDomain et lpszServer ont la valeur NULL.

Il n’existe aucune information d’erreur étendue pour cette fonction ; n’appelez pas GetLastError.

Notes

La fonction RasAdminGetUserAccountServer obtient le nom du serveur avec la base de données des comptes d’utilisateur. Cette fonction nécessite 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 se trouve dans son propre groupe de travail). Dans ce cas, le paramètre lpszServer doit spécifier le nom du serveur. Pour obtenir le nom du serveur, appelez la fonction GetComputerName . Veillez à précéder le nom du serveur avec les caractères « \\ ».

Si le nom de serveur spécifié par lpszServer est un serveur autonome (autrement dit, 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 dans la base de données de compte d’utilisateur.

Spécifications

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	Rassapi.h
Bibliothèque	Rassapi.lib
DLL	Rassapi.dll

Voir aussi

Vue d’ensemble du service d’accès à distance (RAS)

Fonctions d’administration du serveur RAS

GetComputerName

RasAdminUserGetInfo

RasAdminUserSetInfo