共用方式為

LsaOpenTrustedDomainByName 函式 (ntsecapi.h)

  • 發行項

LsaOpenTrustedDomainByName 函式會開啟遠端信任網域的 LSA 原則句柄。 您可以將此句柄傳遞至 LSA 函式呼叫，以設定或查詢遠端電腦的 LSA 原則。

語法

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

參數

[in] PolicyHandle

Policy 物件的句柄。 這是本機計算機的原則句柄。 如需詳細資訊，請參閱 開啟原則物件句柄。

[in] TrustedDomainName

信任的功能變數名稱。 此名稱可以是一般名稱，或功能變數名稱系統 (DNS) 功能變數名稱。

[in] DesiredAccess

ACCESS_MASK 結構，指定遠端信任網域物件上要求的訪問許可權。

[out] TrustedDomainHandle

接收遠端信任網域之 LSA 原則句柄位址的指標。 您可以將此句柄傳遞至 LSA 函式呼叫，以查詢和管理遠端電腦的 LSA 原則。

當您的應用程式不再需要此句柄時，應該呼叫 LsaClose 來刪除句柄。

傳回值

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

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

值 Description
STATUS_ACCESS_DENIED
 呼叫端沒有適當的存取權來完成作業。
STATUS_OBJECT_NAME_NOT_FOUND
 目標系統的 LSA 資料庫中沒有具有指定名稱的 Trusted Domain 物件。
 

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

規格需求

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

另請參閱

LsaClose