Função RasAdminGetUserAccountServer
[Essa função é fornecida apenas para compatibilidade com versões anteriores com o Windows NT Server 4.0. Ele retorna ERROR_CALL_NOT_IMPLEMENTED no Windows Server 2003. Os aplicativos devem usar a função MprAdminGetPDCServer .]
A função RasAdminGetUserAccountServer recupera o nome do servidor que tem o banco de dados da conta de usuário. Use o nome do servidor retornado nas funções RasAdminUserGetInfo e RasAdminUserSetInfo para obter ou definir informações sobre um usuário especificado.
Sintaxe
DWORD RasAdminGetUserAccountServer(
_In_ const WCHAR *lpszDomain,
_In_ const WCHAR *lpszServer,
_Out_ LPWSTR lpszUserAccountServer
);
Parâmetros
-
lpszDomain [in]
-
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do domínio ao qual o servidor RAS pertence. Esse parâmetro é NULL para os aplicativos de administração RAS em execução em estações de trabalho ou servidores que não são membros de um domínio. Se esse parâmetro for NULL, o parâmetro lpszServer deverá ser não NULL.
-
lpszServer [in]
-
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do servidor RAS. Especifique o nome com caracteres "\\" à esquerda, no formato: \\servername. Esse parâmetro poderá ser NULL se o parâmetro lpszDomain não for NULL.
-
lpszUserAccountServer [out]
-
Ponteiro para um buffer que recebe uma cadeia de caracteres Unicode terminada em nulo que especifica o nome de um controlador de domínio que tem o banco de dados da conta de usuário. O buffer deve ser grande o suficiente para manter o nome do servidor (UNCLEN +1). A função prefixa o nome do servidor retornado com caracteres "\\" à esquerda, no formato: \\servername.
Valor retornado
Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor retornado poderá ser o código de erro a seguir.
| Valor | Significado |
|---|---|
|
LpszDomain e lpszServer são NULL. |
Não há informações de erro estendidas para essa função; não chame GetLastError.
Comentários
A função RasAdminGetUserAccountServer obtém o nome do servidor com o banco de dados de contas de usuário. Essa função requer o nome do servidor RAS ou o nome do domínio no qual reside o servidor RAS.
O parâmetro lpszDomain deve especificar um nome de domínio válido. Esse parâmetro é NULL para aplicativos de administração RAS em execução em servidores que não são membros de um domínio (por exemplo, o servidor está em seu próprio grupo de trabalho). Nesse caso, o parâmetro lpszServer deve especificar o nome do servidor. Para obter o nome do servidor, chame a função GetComputerName . Certifique-se de prefixar o nome do servidor com os caracteres "\\".
Se o nome do servidor especificado por lpszServer for um servidor autônomo (ou seja, o servidor ou estação de trabalho não for membro de um domínio), o próprio nome do servidor será retornado no buffer lpszUserAccountServer .
Em seguida, use o nome do servidor de conta de usuário em uma chamada para a função NetQueryDisplayInformation para enumerar os usuários no banco de dados da conta de usuário.
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte ao cliente |
Windows 2000 Professional |
| Fim do suporte ao servidor |
Windows 2000 Server |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|