LsaQueryTrustedDomainInfo 函式 (ntsecapi.h)

發行項
08/08/2024

LsaQueryTrustedDomainInfo 函式會擷取信任網域的相關信息。

語法

NTSTATUS LsaQueryTrustedDomainInfo(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PSID                      TrustedDomainSid,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

參數

[in] PolicyHandle

域控制器之 Policy 物件的句柄，該域控制器與 TrustedDomainSid 參數所識別的網域具有信任關係。句柄必須具有POLICY_VIEW_LOCAL_INFORMATION訪問許可權。如需詳細資訊，請參閱開啟原則物件句柄。

[in] TrustedDomainSid

要查詢之受信任網域的 SID 指標。

[in] InformationClass

從 TRUSTED_INFORMATION_CLASS 列舉型別指定下列其中一個值。值表示所要求的信息類型。

值	意義
TrustedDomainNameInformation	擷取信任網域的名稱。 Buffer 參數會接收TRUSTED_DOMAIN_NAME_INFO結構的指標。
TrustedPosixOffsetInformation	擷取用來產生受信任網域之 Posix 使用者和群組標識碼的值。 Buffer 參數會接收TRUSTED_POSIX_OFFSET_INFO結構的指標。
TrustedPasswordInformation	擷取受信任網域的密碼。 Buffer 參數會接收TRUSTED_PASSWORD_INFO結構的指標。在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_GET_PRIVATE_INFORMATION訪問許可權。
TrustedDomainInformationEx	擷取受信任網域的擴充資訊。 Buffer 參數會接收TRUSTED_DOMAIN_INFORMATION_EX結構的指標。
TrustedDomainInformationBasic	不支援此值。
TrustedDomainFullInformation	擷取信任網域的完整資訊。這項資訊包括 Posix 位移資訊、驗證資訊，以及針對 TrustedDomainInformationEx 值傳回的擴充資訊。 Buffer 參數會接收TRUSTED_DOMAIN_FULL_INFORMATION結構的指標。

[out] Buffer

緩衝區的指標，接收包含所要求信息的結構指標。結構的類型取決於 InformationClass 參數的值。

當您完成使用資訊時，請將傳回的指標傳遞至 LsaFreeMemory 來釋放傳回的指標。

傳回值

如果函式成功，函式會傳回STATUS_SUCCESS。

如果函式失敗，它會傳回 NTSTATUS 值，指出錯誤。如需詳細資訊，請參閱 LSA 原則函式傳回值。

您可以使用 LsaNtStatusToWinError 函式，將 NTSTATUS 值轉換成 Windows 錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	ntsecapi.h
程式庫	Advapi32.lib
Dll	Advapi32.dll