Função DsEnumerateDomainTrustsA (dsgetdc.h)

  • Artigo

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

Confira também

DS_DOMAIN_TRUSTS

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

NetApiBufferFree