DsGetForestTrustInformationW-Funktion (dsgetdc.h)
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 |