LsaQueryInformationPolicy 函式 (ntsecapi.h)

發行項
03/13/2024

LsaQueryInformationPolicy 函式會擷取 Policy 物件的相關信息。

語法

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] PVOID                    *Buffer
);

參數

[in] PolicyHandle

Policy 物件的句柄。此句柄的必要訪問許可權取決於 InformationClass 參數的值。如需詳細資訊，請參閱開啟原則物件句柄。

[in] InformationClass

從 POLICY_INFORMATION_CLASS 列舉型別指定下列其中一個值。值表示要擷取的信息類型。

值	意義
PolicyAuditEventsInformation	擷取系統的稽核規則。在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_VIEW_AUDIT_INFORMATION訪問許可權。 Buffer 參數會接收POLICY_AUDIT_EVENTS_INFO結構的指標。
PolicyPrimaryDomainInformation	擷取系統主要網域的名稱和 SID。在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_VIEW_LOCAL_INFORMATION訪問許可權。 Buffer 參數會接收POLICY_PRIMARY_DOMAIN_INFO結構的指標。
PolicyAccountDomainInformation	擷取系統帳戶網域的名稱和SID。在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_VIEW_LOCAL_INFORMATION訪問許可權。 Buffer 參數會接收POLICY_ACCOUNT_DOMAIN_INFO結構的指標。
PolicyLsaServerRoleInformation	擷取 LSA 伺服器的角色。在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_VIEW_LOCAL_INFORMATION訪問許可權。 Buffer 參數會接收POLICY_LSA_SERVER_ROLE_INFO結構的指標。
PolicyModificationInformation	擷取 LSA 資料庫建立時間和上次修改的相關信息。在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_VIEW_LOCAL_INFORMATION訪問許可權。 Buffer 參數會接收POLICY_MODIFICATION_INFO結構的指標。
PolicyDnsDomainInformation	擷取域名系統 (DNS) 與 Policy 物件相關聯之主要網域的相關信息。在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_VIEW_LOCAL_INFORMATION訪問許可權。 Buffer 參數會接收POLICY_DNS_DOMAIN_INFO結構的指標。

[out] Buffer

變數的指標，該變數會接收包含所要求資訊的結構指標。結構的類型取決於 InformationClass 參數的值。

當您不再需要資訊時，請將傳回的指標傳遞至 LsaFreeMemory。

傳回值

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

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

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

備註

如需示範呼叫此函式的範例，請參閱管理原則資訊。

規格需求

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