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

Vedi anche

Funzioni del servizio directory

NetApiBufferFree

TRUSTED_DOMAIN_INFORMATION_EX