Funzione DsEnumerateDomainTrustsA (dsgetdc.h)
La funzione DsEnumerateDomainTrusts ottiene i dati di attendibilità del dominio per un dominio specificato.
Sintassi
DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
[in, optional] LPSTR ServerName,
[in] ULONG Flags,
[out] PDS_DOMAIN_TRUSTSA *Domains,
[out] PULONG DomainCount
);
Parametri
[in, optional] ServerName
Puntatore a una stringa con terminazione Null che specifica il nome di un computer nel dominio per cui ottenere le informazioni di attendibilità. Se questo parametro è NULL, viene utilizzato il nome del computer locale. Il chiamante deve essere un utente autenticato in questo dominio.
Se il computer è un controller di dominio, questa funzione restituisce immediatamente i dati di attendibilità. Se il computer non è un controller di dominio, questa funzione ottiene i dati di attendibilità dai dati memorizzati nella cache se i dati memorizzati nella cache non sono scaduti. Se i dati memorizzati nella cache sono scaduti, questa funzione ottiene i dati di attendibilità da un controller di dominio nel dominio di cui il computer è membro e aggiorna la cache. I dati memorizzati nella cache scadono automaticamente dopo cinque minuti.
[in] Flags
Contiene un set di flag che determinano quali trust di dominio enumerare. Può essere zero o una combinazione di uno o più dei valori seguenti.
DS_DOMAIN_DIRECT_INBOUND
Enumerare i domini che considerano direttamente attendibile il dominio con NomeServer come membro.
DS_DOMAIN_DIRECT_OUTBOUND
Enumerare i domini direttamente attendibili dal dominio con NomeServer come membro.
DS_DOMAIN_IN_FOREST
Enumerare i domini membri della stessa foresta con NomeServer come membro.
DS_DOMAIN_NATIVE_MODE
Enumerare i domini in cui il dominio primario è in esecuzione in modalità nativa di Windows 2000.
DS_DOMAIN_PRIMARY
Enumerare i domini che sono il dominio primario del dominio con NomeServer come membro.
DS_DOMAIN_TREE_ROOT
Enumerare i domini che si trovano nella radice della foresta con NomeServer come membro.
[out] Domains
Puntatore a un valore PDS_DOMAIN_TRUSTS che riceve una matrice di strutture DS_DOMAIN_TRUSTS. Ogni struttura in questa matrice contiene dati di attendibilità relativi a un dominio. Il chiamante deve liberare questa memoria quando non è più necessaria chiamando NetApiBufferFree.
[out] DomainCount
Puntatore a un valore di
Valore restituito
Restituisce ERROR_SUCCESS se ha esito positivo o un codice di errore Win32 in caso contrario. I codici di errore possibili includono quelli elencati nell'elenco seguente.
Osservazioni
Nota
L'intestazione dsgetdc.h definisce DsEnumerateDomainTrusts come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| server minimo supportato | Windows Server 2008 |
| piattaforma di destinazione | Finestre |
| intestazione |
dsgetdc.h |
| libreria |
Netapi32.lib |
| dll | Netapi32.dll |