LsaOpenPolicy 函式 (ntsecapi.h)

LsaOpenPolicy 函式會開啟本機或遠端系統上 Policy 物件的句柄。

您必須執行「以系統管理員身分」的程式，讓呼叫不會因為ERROR_ACCESS_DENIED而失敗。

語法

NTSTATUS LsaOpenPolicy(
  [in]      PLSA_UNICODE_STRING    SystemName,
  [in]      PLSA_OBJECT_ATTRIBUTES ObjectAttributes,
  [in]      ACCESS_MASK            DesiredAccess,
  [in, out] PLSA_HANDLE            PolicyHandle
);

參數

[in] SystemName

包含目標系統名稱 之LSA_UNICODE_STRING 結構的指標。 名稱的格式可以是 「ComputerName」 或 「\\ComputerName」。。 如果此參數為 NULL，函式會在本機系統上開啟 Policy 物件。

[in] ObjectAttributes

指定連接屬性之LSA_OBJECT_ATTRIBUTES結構的指標。 不會使用結構成員;將它們初始化為 NULL 或零。

[in] DesiredAccess

指定所要求訪問許可權 的ACCESS_MASK 。 如果目標系統的 DACL 不允許呼叫端要求的存取權，則函式會失敗。 若要判斷您需要的訪問許可權，請參閱要使用原則句柄之 LSA 函式的檔。

[in, out] PolicyHandle

接收 Policy 物件句柄之LSA_HANDLE變數的指標。

當您不再需要此句柄時，請將它傳遞給 LsaClose 函式以關閉它。

傳回值

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

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

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

備註

若要管理本機或遠端系統的本機安全策略，您必須呼叫 LsaOpenPolicy 函式，以建立與該系統 LSA 子系統的工作階段。 LsaOpenPolicy 會連接到目標系統的 LSA，並將句柄傳回給該系統的 Policy 物件。 您可以在後續的 LSA 函數呼叫中使用此句柄來管理目標系統的 本機安全策略 資訊。

如需示範呼叫此函式的範例，請參閱 開啟原則物件句柄。

規格需求

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

另請參閱

LSA_HANDLE

LSA_OBJECT_ATTRIBUTES

LSA_UNICODE_STRING

LsaClose

LsaNtStatusToWinError