DsGetForestTrustInformationW-Funktion (dsgetdc.h)

Artikel
08/23/2023

Die DsGetForestTrustInformationW-Funktion ruft Gesamtstrukturvertrauensdaten für eine angegebene Domäne ab.

Syntax

DSGETDCAPI DWORD DsGetForestTrustInformationW(
  [in, optional] LPCWSTR                       ServerName,
  [in, optional] LPCWSTR                       TrustedDomainName,
  [in]           DWORD                         Flags,
  [out]          PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

Parameter

[in, optional] ServerName

Enthält den Namen des Domänencontrollers, mit dem DsGetForestTrustInformationW remote verbunden ist. Der Aufrufer muss ein authentifizierter Benutzer auf diesem Server sein. Wenn dieser Parameter NULL ist, wird der lokale Server verwendet.

[in, optional] TrustedDomainName

Enthält den NETBIOS- oder DNS-Namen der vertrauenswürdigen Domäne, für die die Gesamtstrukturvertrauensdaten abgerufen werden sollen. Diese Domäne muss über das attribut TRUST_ATTRIBUTE_FOREST_TRANSITIVE trust verfügen. Weitere Informationen finden Sie unter TRUSTED_DOMAIN_INFORMATION_EX.

Wenn dieser Parameter NULL ist, werden die Gesamtstrukturvertrauensdaten für die von ServerName gehostete Domäne abgerufen.

[in] Flags

Enthält eine Reihe von Flags, die das Verhalten dieser Funktion ändern. Dies kann null oder der folgende Wert sein.

DS_GFTI_UPDATE_TDO

Wenn dieses Flag festgelegt ist, aktualisiert DsGetForestTrustInformationW die Gesamtstrukturvertrauensdaten der durch den TrustedDomainName-Parameter identifizierten vertrauenswürdigen Domäne. In diesem Fall kann der TrustedDomainName-Parameter nicht NULL sein. Der Aufrufer muss Zugriff haben, um die Vertrauensstellungsdaten zu ändern , oder ERROR_ACCESS_DENIED zurückgegeben wird.

Dieses Flag ist nur gültig, wenn ServerName den primären Domänencontroller der Domäne angibt.

[out] ForestTrustInfo

Zeiger auf einen LSA_FOREST_TRUST_INFORMATION Strukturzeiger, der die Gesamtstrukturvertrauensdaten empfängt, die die Namespaces beschreibt, die von der durch TrustedDomainName angegebenen Domäne beansprucht werden. Das Time-Element aller zurückgegebenen Datensätze ist 0.

Der Aufrufer muss diese Struktur freigeben, wenn sie nicht mehr benötigt wird, indem Er NetApiBufferFree aufruft.

Rückgabewert

Gibt NO_ERROR zurück, wenn erfolgreich oder andernfalls ein Win32-Fehlercode. Mögliche Fehlercodes sind:

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	dsgetdc.h
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

Verzeichnisdienstfunktionen

NetApiBufferFree

TRUSTED_DOMAIN_INFORMATION_EX

Freigeben über