共用方式為

LsaQueryTrustedDomainInfoByName 函式 (ntsecapi.h)

  • 發行項

LsaQueryTrustedDomainInfoByName 函式會傳回受信任網域的相關信息。

語法

NTSTATUS LsaQueryTrustedDomainInfoByName(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PLSA_UNICODE_STRING       TrustedDomainName,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

參數

[in] PolicyHandle

Policy 物件的句柄。 此句柄必須具有POLICY_VIEW_LOCAL_INFORMATION訪問許可權。 如需詳細資訊，請參閱 開啟原則物件句柄。

[in] TrustedDomainName

包含受信任網域名稱的字串。 這可以是功能變數名稱或一般名稱。

[in] InformationClass

指定要擷取的信息類型。 此參數可以是下列其中一個值。

值 意義
TrustedDomainNameInformation
 信任網域的名稱。
TrustedPosixInformation
 受信任網域的Posix位移。
TrustedPasswordInformation
 傳回信任輸出端的密碼。
TrustedDomainInformationBasic
 不支援這個值。
TrustedDomainInformationEx
 延伸信任資訊，包括基本資訊和 DNS 功能變數名稱，以及有關信任的屬性。
TrustedDomainFullInformation
 完整資訊，包括 Posix 位移和驗證資訊。

[out] Buffer

接收傳回緩衝區的指標，其中包含要求的資訊。 這個緩衝區的格式和內容取決於信息類別。 例如，如果 InformationClass 設定為 TrustedDomainInformationEx，Buffer 會收到 TRUSTED_DOMAIN_INFORMATION_EX結構的指標。 如需詳細資訊，請參閱 TRUSTED_INFORMATION_CLASS。

當您完成使用緩衝區時，請呼叫 LsaFreeMemory 函式 來釋放緩衝區。

傳回值

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

如果函式失敗，它會傳回 NTSTATUS 值，可以是下列其中一個值或其中一個 LSA原則函式傳回值。

值 Description
STATUS_ACCESS_DENIED
 呼叫端沒有適當的存取權可完成作業。 如需必要存取類型的清單，請參閱 InformationClass 參數的描述。
STATUS_INSUFFICIENT_資源
 系統資源不足，例如記憶體，無法完成呼叫。
 

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

規格需求

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

另請參閱

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS