Funzione LsaEnumerateTrustedDomainsEx (ntsecapi.h)
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 |
|---|---|
|
Il chiamante non dispone dell'accesso appropriato per completare l'operazione. |
|
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
- Impostare la variabile a cui fa riferimento EnumerationContext su zero.
- Se LsaEnumerateTrustedDomainsEx restituisce STATUS_SUCCESS o STATUS_MORE_ENTRIES, chiamare nuovamente la funzione, passando il valore EnumerationContext restituito dalla chiamata precedente.
- 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 |