LsaSetInformationPolicy 函式 (ntsecapi.h)

LsaSetInformationPolicy 函式會修改 Policy 物件中的資訊。

語法

NTSTATUS LsaSetInformationPolicy(
  [in] LSA_HANDLE               PolicyHandle,
  [in] POLICY_INFORMATION_CLASS InformationClass,
  [in] PVOID                    Buffer
);

參數

[in] PolicyHandle

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

[in] InformationClass

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

值	意義
PolicyAuditEventsInformation	設定系統的稽核規則。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_SET_AUDIT_REQUIREMENTS訪問許可權。 Buffer 參數必須是POLICY_AUDIT_EVENTS_INFO結構的指標。
PolicyPrimaryDomainInformation	設定系統主要網域的名稱和 SID。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_TRUST_ADMIN訪問許可權。 Buffer 參數必須是POLICY_PRIMARY_DOMAIN_INFO結構的指標。
PolicyAccountDomainInformation	設定系統帳戶網域的名稱和 SID。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_TRUST_ADMIN訪問許可權。 Buffer 參數必須是POLICY_ACCOUNT_DOMAIN_INFO結構的指標。
PolicyDnsDomainInformation	設定功能變數名稱系統 (DNS) 與 原則 對象相關聯之主要網域的相關信息。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_TRUST_ADMIN訪問許可權。 Buffer 參數必須是POLICY_DNS_DOMAIN_INFO結構的指標。
PolicyLsaServerRoleInformation	設定 LSA 伺服器的角色。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_SERVER_ADMIN訪問許可權。 Buffer 參數必須是POLICY_LSA_SERVER_ROLE_INFO結構的指標。 雖然函式傳回STATUS_SUCCESS) ，但是將伺服器的角色從主要變更為備份沒有任何作用 (。 將伺服器的角色從備份變更為主要伺服器需要廣泛的網路作業，而且速度可能很慢。

[in] Buffer

結構指標，其中包含要設定的資訊。 結構的類型取決於 InformationClass 參數的值。

傳回值

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

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

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

規格需求

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

另請參閱

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO