Função DsEnumerateDomainTrustsA (dsgetdc.h)
A função DsEnumerateDomainTrusts obtém dados de confiança de domínio para um domínio especificado.
Sintaxe
DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
[in, optional] LPSTR ServerName,
[in] ULONG Flags,
[out] PDS_DOMAIN_TRUSTSA *Domains,
[out] PULONG DomainCount
);
Parâmetros
[in, optional] ServerName
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome de um computador no domínio para o qual obter as informações de confiança. Se esse parâmetro for NULL, o nome do computador local será usado. O chamador deve ser um usuário autenticado neste domínio.
Se esse computador for um controlador de domínio, essa função retornará os dados de confiança imediatamente. Se este computador não for um controlador de domínio, essa função obterá os dados de confiança de dados armazenados em cache se os dados armazenados em cache não expirarem. Se os dados armazenados em cache expirarem, essa função obterá os dados de confiança de um controlador de domínio no domínio do qual este computador é membro e atualizará o cache. Os dados armazenados em cache expiram automaticamente após cinco minutos.
[in] Flags
Contém um conjunto de sinalizadores que determina quais domínios confiam para enumerar. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.
DS_DOMAIN_DIRECT_INBOUND
Enumerar domínios que confiam diretamente no domínio que tem ServerName como membro.
DS_DOMAIN_DIRECT_OUTBOUND
Enumerar domínios diretamente confiáveis pelo domínio que tem ServerName como membro.
DS_DOMAIN_IN_FOREST
Enumerar domínios que são membros da mesma floresta que tem ServerName como membro.
DS_DOMAIN_NATIVE_MODE
Enumerar domínios em que o domínio primário está em execução no modo nativo do Windows 2000.
DS_DOMAIN_PRIMARY
Enumerar domínios que são o domínio primário do domínio que tem ServerName como membro.
DS_DOMAIN_TREE_ROOT
Enumerar domínios que estão na raiz da floresta que tem ServerName como membro.
[out] Domains
Ponteiro para um valor PDS_DOMAIN_TRUSTS que recebe uma matriz de estruturas DS_DOMAIN_TRUSTS . Cada estrutura nessa matriz contém dados de confiança sobre um domínio. O chamador deve liberar essa memória quando ela não for mais necessária chamando NetApiBufferFree.
[out] DomainCount
Ponteiro para um valor ULONG que recebe o número de elementos retornados na matriz Domains .
Retornar valor
Retorna ERROR_SUCCESS se tiver êxito ou um código de erro Win32 caso contrário. Os códigos de erro possíveis incluem os listados na lista a seguir.
Comentários
Observação
O cabeçalho dsgetdc.h define DsEnumerateDomainTrusts como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | dsgetdc.h |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |