Compartilhar via


Função DsRoleGetPrimaryDomainInformation (dsrole.h)

A função DsRoleGetPrimaryDomainInformation recupera dados de estado para o computador. Esses dados incluem o estado da instalação do serviço de diretório e dos dados de domínio.

Sintaxe

DWORD DsRoleGetPrimaryDomainInformation(
  [in]  LPCWSTR                          lpServer,
  [in]  DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
  [out] PBYTE                            *Buffer
);

Parâmetros

[in] lpServer

Ponteiro para cadeia de caracteres Unicode terminada em nulo que contém o nome do computador no qual chamar a função. Se esse parâmetro for NULL, o computador local será usado.

[in] InfoLevel

Contém um dos valores DSROLE_PRIMARY_DOMAIN_INFO_LEVEL que especificam o tipo de dados a serem recuperados. Esse parâmetro também determina o formato dos dados fornecidos no Buffer.

[out] Buffer

Ponteiro para o endereço de um buffer que recebe os dados solicitados. O formato desses dados depende do valor do parâmetro InfoLevel .

O chamador deve liberar essa memória quando ela não for mais necessária chamando DsRoleFreeMemory.

Retornar valor

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

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho dsrole.h
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

Funções de serviço de diretório

DsRoleFreeMemory