Funzione DsGetForestTrustInformationW (dsgetdc.h)
La funzione DsGetForestTrustInformationW ottiene i dati di trust della foresta per un dominio specificato.
Sintassi
DSGETDCAPI DWORD DsGetForestTrustInformationW(
[in, optional] LPCWSTR ServerName,
[in, optional] LPCWSTR TrustedDomainName,
[in] DWORD Flags,
[out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);
Parametri
[in, optional] ServerName
Contiene il nome del controller di dominio a cui DsGetForestTrustInformationW è connesso in remoto. Il chiamante deve essere un utente autenticato in questo server. Se questo parametro è NULL, viene usato il server locale.
[in, optional] TrustedDomainName
Contiene il nome NETBIOS o DNS del dominio attendibile per cui devono essere recuperati i dati di trust della foresta. Questo dominio deve avere l'attributo di attendibilità TRUST_ATTRIBUTE_FOREST_TRANSITIVE . Per altre informazioni, vedere TRUSTED_DOMAIN_INFORMATION_EX.
Se questo parametro è NULL, vengono recuperati i dati di trust della foresta per il dominio ospitato da ServerName .
[in] Flags
Contiene un set di flag che modificano il comportamento di questa funzione. Questo valore può essere zero o il valore seguente.
DS_GFTI_UPDATE_TDO
Se questo flag è impostato, DsGetForestTrustInformationW aggiornerà i dati di trust della foresta del dominio attendibile identificato dal parametro TrustedDomainName . In questo caso, il parametro TrustedDomainName non può essere NULL. Il chiamante deve avere accesso per modificare i dati di attendibilità o ERROR_ACCESS_DENIED viene restituito.
Questo flag è valido solo se ServerName specifica il controller di dominio primario del dominio.
[out] ForestTrustInfo
Puntatore a un puntatore LSA_FOREST_TRUST_INFORMATION struttura che riceve i dati di trust della foresta che descrivono gli spazi dei nomi richiesti dal dominio specificato da TrustedDomainName. Il membro Time di tutti i record restituiti sarà zero.
Il chiamante deve liberare questa struttura quando non è più richiesto chiamando NetApiBufferFree.
Valore restituito
Restituisce NO_ERROR se ha esito positivo o un codice di errore Win32 in caso contrario. I codici di errore possibili includono quanto segue.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | dsgetdc.h |
| Libreria | Netapi32.lib |
| DLL | Netapi32.dll |