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_PRIMARY_DOMAIN_INFO_BASIC