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
ERROR_INVALID_PARAMETER	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	Rassapi.h
Biblioteca	Rassapi.lib
DLL	Rassapi.dll

Confira também

Visão geral do RAS (Serviço de Acesso Remoto)

Funções de administração do servidor RAS

GetComputerName

RasAdminUserGetInfo

RasAdminUserSetInfo