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 |
|---|---|
|
O chamador não tem o acesso apropriado para concluir a operação. |
|
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
- Defina a variável apontada por EnumerationContext como zero.
- Se LsaEnumerateTrustedDomainsEx retornar STATUS_SUCCESS ou STATUS_MORE_ENTRIES, chame a função novamente, passando o valor EnumerationContext retornado pela chamada anterior.
- 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 |