Funzione MprAdminGetPDCServer (mprapi.h)

Articolo
02/29/2024

La funzione MprAdminGetPDCServer recupera il nome del server con il sottosistema account utente master (UAS) da un nome di dominio o da un nome server. Il parametro del nome di dominio o il parametro del nome del server può essere NULL, ma non entrambi.

Sintassi

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

Parametri

[in] lpszDomain

Puntatore a una stringa Unicode con terminazione Null che specifica il nome del dominio a cui appartiene il server RAS. Questo parametro può essere NULL se si esegue l'applicazione di amministrazione RAS in un server Windows NT/Windows 2000 che non fa parte di un dominio. Se questo parametro è NULL, il parametro lpwsServerName non deve essere NULL.

[in] lpszServer

Puntatore a una stringa Unicode con terminazione Null che specifica il nome del server RAS windows NT/Windows 2000. Specificare il nome con caratteri "\" iniziali, nel formato \nomeserver. Questo parametro può essere NULL se il parametro lpwsDomain non è NULL.

[out] lpszPDCServer

Puntatore a un buffer che riceve una stringa Unicode con terminazione Null contenente il nome di un controller di dominio con il database dell'account utente. Il buffer deve essere sufficientemente grande da contenere il nome del server (UNCLEN +1). La funzione antepone il nome del server restituito con caratteri "\" iniziali, nel formato \nomeserver.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei valori seguenti.

Valore	Significato
ERROR_NO_SUCH_DOMAIN	Il dominio specificato non è valido.
NERR_InvalidComputer	Il parametro lpwsDomainName è NULL e il parametro lpwsServerName non è valido.

Commenti

La funzione MprAdminGetPDCServer può ottenere il nome del server con il database degli account utente in base al nome del server RAS o al nome del dominio in cui risiede il server RAS. Per ottenere il nome del server, chiamare la funzione GetComputerName

Se il nome del server specificato da lpszServer fa parte di un dominio, il server restituito da MprAdminGetPDCServer sarà il controller di dominio primario o un controller di dominio di backup.

Se il nome del server specificato da lpszServer è un server Windows NT/Windows 2000 autonomo, ovvero il server o la workstation non fa parte di un dominio, il nome del server stesso viene restituito nel buffer lpszUserAccountServer .

È quindi possibile usare il nome del server dell'account utente in una chiamata alla funzione NetQueryDisplayInformation per enumerare gli utenti nel database dell'account utente. È anche possibile usare il nome del server nelle chiamate alle funzioni MprAdminUserGetInfo e MprAdminUserSetInfo per ottenere e impostare privilegi RAS per un account utente specificato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll