DsGetForestTrustInformationW 函式 (dsgetdc.h)
DsGetForestTrustInformationW函式會取得指定網域的樹系信任資料。
語法
DSGETDCAPI DWORD DsGetForestTrustInformationW(
[in, optional] LPCWSTR ServerName,
[in, optional] LPCWSTR TrustedDomainName,
[in] DWORD Flags,
[out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);
參數
[in, optional] ServerName
包含 DsGetForestTrustInformationW 從遠端連線的網域控制站名稱。 呼叫端必須是此伺服器上的已驗證使用者。 如果此參數為 Null，則會使用本機伺服器。
[in, optional] TrustedDomainName
包含要擷取樹系信任資料的受信任網域 NETBIOS 或 DNS 名稱。 此網域必須具有 TRUST_ATTRIBUTE_FOREST_TRANSITIVE 信任屬性。 如需詳細資訊，請參閱 TRUSTED_DOMAIN_INFORMATION_EX。
如果此參數為 Null，則會擷取 ServerName 所裝載網域的樹系信任資料。
[in] Flags
包含一組旗標，可修改此函式的行為。 這可以是零或下列值。
DS_GFTI_UPDATE_TDO
如果設定此旗標， DsGetForestTrustInformationW 將會更新 TrustedDomainName 參數所識別受信任網域的樹系信任資料。 在此情況下， TrustedDomainName 參數不可以是 Null。 呼叫端必須具有修改信任資料或 傳回ERROR_ACCESS_DENIED 的存取權。
只有當 ServerName 指定網域的主要網域控制站時，此旗標才有效。
[out] ForestTrustInfo
LSA_FOREST_TRUST_INFORMATION結構指標的指標，該指標會接收樹系信任資料，其描述TrustedDomainName所指定之網域所宣告的命名空間。 所有傳回記錄 的時間成員都會 是零。
呼叫 NetApiBufferFree不再需要呼叫此結構時，呼叫端必須釋放此結構。
傳回值
如果成功或 Win32 錯誤碼，則傳回 NO_ERROR 否則傳回 。 可能的錯誤碼包括下列專案。
需求
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | dsgetdc.h |
| 程式庫 | Netapi32.lib |
| Dll | Netapi32.dll |