Funzione LsaEnumerateTrustedDomainsEx (ntsecapi.h)

  • Articolo

La funzione LsaEnumerateTrustedDomainsEx restituisce informazioni sui domini attendibili dal sistema locale. LsaEnumerateTrustedDomainsEx restituisce informazioni solo sui trust diretti. DsEnumerateDomainTrusts è consigliato per scopi di enumerazione attendibili più completi.

Sintassi

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

Parametri

[in] PolicyHandle

Handle a un oggetto Policy . Questa chiamata richiede POLICY_VIEW_LOCAL_INFORMATION l'accesso all'oggetto Policy . Per altre informazioni, vedere Apertura di un handle oggetto Criteri.

[in] EnumerationContext

Puntatore a un LSA_ENUMERATION_HANDLE che è possibile usare per eseguire più chiamate a LsaEnumerateTrustedDomainsEx per recuperare tutte le informazioni di dominio attendibili. Per altre informazioni, vedere la sezione Osservazioni.

[out] Buffer

Puntatore a un buffer che riceve un elenco di strutture TRUSTED_DOMAIN_INFORMATION_EX che contengono informazioni sui domini attendibili enumerati.

L'applicazione deve liberare questo buffer quando non è più necessario chiamando LsaFreeMemory.

[in] PreferedMaximumLength

Lunghezza massima preferita, in byte, di dati restituiti. Non si tratta di un limite massimo rigido, ma funge da guida. A causa della conversione dei dati tra sistemi con dimensioni dei dati naturali diverse, la quantità effettiva di dati restituiti può essere maggiore di questo valore.

[out] CountReturned

Puntatore a long che riceve il numero di oggetti di dominio attendibili restituiti.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce STATUS_SUCCESS.

Se la funzione ha esito negativo, restituisce un codice NTSTATUS , che può essere uno dei valori seguenti o uno dei valori restituiti della funzione Criteri LSA.

Valore Descrizione
STATUS_ACCESS_DENIED
 Il chiamante non dispone dell'accesso appropriato per completare l'operazione.
STATUS_NO_MORE_ENTRIES
 Non ci sono più voci. Questo avviso viene restituito se non sono stati enumerati oggetti perché il valore EnumerationContext è troppo elevato.
 

È possibile usare la funzione LsaNtStatusToWinError per convertire il codice NTSTATUS in un codice di errore di Windows.

Commenti

Il recupero di tutte le informazioni di trust può richiedere più di una singola chiamata LsaEnumerateTrustedDomainsEx .

Per usare il parametro EnumerationContext per effettuare più chiamate

  1. Impostare la variabile a cui fa riferimento EnumerationContext su zero.
  2. Se LsaEnumerateTrustedDomainsEx restituisce STATUS_SUCCESS o STATUS_MORE_ENTRIES, chiamare nuovamente la funzione, passando il valore EnumerationContext restituito dalla chiamata precedente.
  3. L'enumerazione viene completata quando la funzione restituisce STATUS_NO_MORE_ENTRIES.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecapi.h
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

LSA_ENUMERATION_HANDLE

LsaFreeMemory

TRUSTED_DOMAIN_INFORMATION_EX