Fonction MprAdminGetPDCServer (mprapi.h)

Article
03/04/2024

La fonction MprAdminGetPDCServer récupère le nom du serveur avec le master User Accounts Subsystem (UAS) à partir d’un nom de domaine ou d’un nom de serveur. Le paramètre de nom de domaine ou le paramètre de nom de serveur peuvent avoir la valeur NULL, mais pas les deux.

Syntaxe

DWORD MprAdminGetPDCServer(
  [in]  LPCWSTR lpszDomain,
  [in]  LPCWSTR lpszServer,
  [out] LPWSTR  lpszPDCServer
);

Paramètres

[in] lpszDomain

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 peut avoir la valeur NULL si vous exécutez votre application d’administration RAS sur un serveur Windows NT/Windows 2000 qui ne participe pas à un domaine. Si ce paramètre a la valeur NULL, le paramètre lpwsServerName ne doit pas avoir la valeur NULL.

[in] lpszServer

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

[out] lpszPDCServer

Pointeur vers une mémoire tampon qui reçoit une chaîne Unicode terminée par null qui contient 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 NO_ERROR.

Si la fonction échoue, la valeur de retour est l’une des valeurs suivantes.

Valeur	Signification
ERROR_NO_SUCH_DOMAIN	Le domaine spécifié n’est pas valide.
NERR_InvalidComputer	Le paramètre lpwsDomainName a la valeur NULL et le paramètre lpwsServerName n’est pas valide.

Remarques

La fonction MprAdminGetPDCServer peut obtenir le nom du serveur avec la base de données des comptes d’utilisateur en fonction du nom du serveur RAS ou du nom du domaine dans lequel réside le serveur RAS. Pour obtenir le nom du serveur, appelez la fonction GetComputerName

Si le nom de serveur spécifié par lpszServer fait partie d’un domaine, le serveur retourné par MprAdminGetPDCServer sera le contrôleur de domaine principal ou un contrôleur de domaine de sauvegarde.

Si le nom de serveur spécifié par lpszServer est un serveur Windows NT/Windows 2000 autonome (autrement dit, le serveur ou la station de travail ne participe pas à un domaine), le nom du serveur lui-même est retourné dans la mémoire tampon lpszUserAccountServer .

Vous pouvez ensuite utiliser 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. Vous pouvez également utiliser le nom du serveur dans les appels aux fonctions MprAdminUserGetInfo et MprAdminUserSetInfo pour obtenir et définir des privilèges RAS pour un compte d’utilisateur spécifié.

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