Funzione RasAdminGetUserAccountServer

[Questa funzione viene fornita solo per la compatibilità con le versioni precedenti con Windows NT Server 4.0. Restituisce ERROR_CALL_NOT_IMPLEMENTED in Windows Server 2003. Le applicazioni devono usare la funzione MprAdminGetPDCServer .]

La funzione RasAdminGetUserAccountServer recupera il nome del server con il database dell'account utente. Usare il nome del server restituito nelle funzioni RasAdminUserGetInfo e RasAdminUserSetInfo per ottenere o impostare informazioni su un utente specificato.

Sintassi

DWORD RasAdminGetUserAccountServer(
  _In_  const WCHAR  *lpszDomain,
  _In_  const WCHAR  *lpszServer,
  _Out_       LPWSTR lpszUserAccountServer
);

Parametri

lpszDomain [in]

Puntatore a una stringa Unicode con terminazione Null che specifica il nome del dominio a cui appartiene il server RAS. Questo parametro è NULL per le applicazioni di amministrazione RAS in esecuzione su workstation o server che non sono membri di un dominio. Se questo parametro è NULL, il parametro lpszServer deve essere diverso da NULL.

lpszServer [in]

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

lpszUserAccountServer [out]

Puntatore a un buffer che riceve una stringa Unicode con terminazione Null che specifica 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 ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere il codice di errore seguente.

Valore	Significato
ERROR_INVALID_PARAMETER	Sia lpszDomain che lpszServer sono NULL.

Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.

Commenti

La funzione RasAdminGetUserAccountServer ottiene il nome del server con il database degli account utente. Questa funzione richiede il nome del server RAS o il nome del dominio in cui risiede il server RAS.

Il parametro lpszDomain deve specificare un nome di dominio valido. Questo parametro è NULL per le applicazioni di amministrazione RAS in esecuzione su server che non sono membri di un dominio( ad esempio, il server si trova nel proprio gruppo di lavoro). In questo caso, il parametro lpszServer deve specificare il nome del server. Per ottenere il nome del server, chiamare la funzione GetComputerName . Assicurarsi di anteporre al nome del server i caratteri "\\".

Se il nome del server specificato da lpszServer è un server autonomo , ovvero il server o la workstation non è membro di un dominio, il nome del server stesso viene restituito nel buffer lpszUserAccountServer .

Usare quindi il nome del server dell'account utente in una chiamata alla funzione NetQueryDisplayInformation per enumerare gli utenti nel database dell'account utente.

Requisiti

Requisito	Valore
Fine del supporto client	Windows 2000 Professional
Fine del supporto server	Windows 2000 Server
Intestazione	Rassapi.h
Libreria	Rassapi.lib
DLL	Rassapi.dll

Vedi anche

Panoramica del servizio accesso remoto (RAS)

Funzioni di amministrazione del server RAS

GetComputerName

RasAdminUserGetInfo

RasAdminUserSetInfo