Função MprAdminGetPDCServer (mprapi.h)

Artigo
03/15/2023

A função MprAdminGetPDCServer recupera o nome do servidor com o subsistema de contas de usuário master (UAS) de um nome de domínio ou de um nome de servidor. O parâmetro de nome de domínio ou o parâmetro de nome do servidor podem ser NULL, mas não ambos.

Sintaxe

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

Parâmetros

[in] lpszDomain

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 poderá ser NULL se você estiver executando seu aplicativo de administração RAS em um servidor Windows NT/Windows 2000 que não esteja participando de um domínio. Se esse parâmetro for NULL, o parâmetro lpwsServerName não deverá ser NULL.

[in] lpszServer

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do servidor RAS do Windows NT/Windows 2000. Especifique o nome com caracteres "\" à esquerda, no formato: \servername. Esse parâmetro poderá ser NULL se o parâmetro lpwsDomain não for NULL.

[out] lpszPDCServer

Ponteiro para um buffer que recebe uma cadeia de caracteres Unicode terminada em nulo que contém 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.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos valores a seguir.

Valor	Significado
ERROR_NO_SUCH_DOMAIN	O domínio especificado não é válido.
NERR_InvalidComputer	O parâmetro lpwsDomainName é NULL e o parâmetro lpwsServerName não é válido.

Comentários

A função MprAdminGetPDCServer pode obter o nome do servidor com o banco de dados de contas de usuário dado o nome do servidor RAS ou o nome do domínio no qual reside o servidor RAS. Para obter o nome do servidor, chame a função GetComputerName

Se o nome do servidor especificado por lpszServer fizer parte de um domínio, o servidor retornado por MprAdminGetPDCServer será o controlador de domínio primário ou um controlador de domínio de backup.

Se o nome do servidor especificado por lpszServer for um servidor autônomo Windows NT/Windows 2000 (ou seja, o servidor ou a estação de trabalho não participa de um domínio), o próprio nome do servidor será retornado no buffer lpszUserAccountServer.

Em seguida, você pode usar 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. Você também pode usar o nome do servidor em chamadas para as funções MprAdminUserGetInfo e MprAdminUserSetInfo para obter e definir privilégios RAS para uma conta de usuário especificada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h
Biblioteca	Mprapi.lib
DLL	Mprapi.dll