Compartilhar via


Função LsaEnumerateTrustedDomainsEx (ntsecapi.h)

A função LsaEnumerateTrustedDomainsEx retorna informações sobre os domínios confiáveis pelo sistema local. LsaEnumerateTrustedDomainsEx retorna informações somente sobre relações de confiança diretas. DsEnumerateDomainTrusts é recomendado para fins de enumeração de confiança mais completos.

Sintaxe

NTSTATUS LsaEnumerateTrustedDomainsEx(
  [in]  LSA_HANDLE              PolicyHandle,
  [in]  PLSA_ENUMERATION_HANDLE EnumerationContext,
  [out] PVOID                   *Buffer,
  [in]  ULONG                   PreferedMaximumLength,
  [out] PULONG                  CountReturned
);

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . Essa chamada requer acesso POLICY_VIEW_LOCAL_INFORMATION ao objeto Policy . Para obter mais informações, consulte Abrindo um identificador de objeto de política.

[in] EnumerationContext

Um ponteiro para um LSA_ENUMERATION_HANDLE que você pode usar para fazer várias chamadas para LsaEnumerateTrustedDomainsEx para recuperar todas as informações de domínio confiáveis. Para obter mais informações, consulte Comentários.

[out] Buffer

Ponteiro para um buffer que recebe uma lista de estruturas TRUSTED_DOMAIN_INFORMATION_EX que contêm informações sobre os domínios confiáveis enumerados.

Seu aplicativo deve liberar esse buffer quando ele não for mais necessário chamando LsaFreeMemory.

[in] PreferedMaximumLength

Comprimento máximo preferencial, em bytes, de dados retornados. Este não é um limite superior rígido, mas serve como um guia. Devido à conversão de dados entre sistemas com diferentes tamanhos de dados naturais, a quantidade real de dados retornados pode ser maior que esse valor.

[out] CountReturned

Ponteiro para um LONG que recebe o número de objetos de domínio confiáveis retornados.

Retornar valor

Se a função for bem-sucedida, a função retornará STATUS_SUCCESS.

Se a função falhar, ela retornará um código NTSTATUS , que pode ser um dos valores a seguir ou um dos valores retornados da função de política LSA.

Valor Descrição
STATUS_ACCESS_DENIED
O chamador não tem o acesso apropriado para concluir a operação.
STATUS_NO_MORE_ENTRIES
Não há mais entradas. Esse aviso será retornado se nenhum objeto tiver sido enumerado porque o valor EnumerationContext é muito alto.
 

Você pode usar a função LsaNtStatusToWinError para converter o código NTSTATUS em um código de erro do Windows.

Comentários

A recuperação de todas as informações de confiança pode exigir mais de uma única chamada LsaEnumerateTrustedDomainsEx .

Para usar o parâmetro EnumerationContext para fazer várias chamadas

  1. Defina a variável apontada por EnumerationContext como zero.
  2. Se LsaEnumerateTrustedDomainsEx retornar STATUS_SUCCESS ou STATUS_MORE_ENTRIES, chame a função novamente, passando o valor EnumerationContext retornado pela chamada anterior.
  3. A enumeração é concluída quando a função retorna STATUS_NO_MORE_ENTRIES.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

LSA_ENUMERATION_HANDLE

LsaFreeMemory

TRUSTED_DOMAIN_INFORMATION_EX