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 |
---|---|
|
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 |
|
Libreria |
|
DLL |
|