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 列舉型別指定下列其中一個值。 值表示要設定的信息類型。
| 值 | 意義 |
|---|---|
|
設定系統的稽核規則。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_SET_AUDIT_REQUIREMENTS訪問許可權。 Buffer 參數必須是POLICY_AUDIT_EVENTS_INFO結構的指標。 |
|
設定系統主要網域的名稱和 SID。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_TRUST_ADMIN訪問許可權。 Buffer 參數必須是POLICY_PRIMARY_DOMAIN_INFO結構的指標。 |
|
設定系統帳戶網域的名稱和 SID。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_TRUST_ADMIN訪問許可權。 Buffer 參數必須是POLICY_ACCOUNT_DOMAIN_INFO結構的指標。 |
|
設定功能變數名稱系統 (DNS) 與 原則 對象相關聯之主要網域的相關信息。 在 PolicyHandle 參數中傳遞的句柄必須具有POLICY_TRUST_ADMIN訪問許可權。 Buffer 參數必須是POLICY_DNS_DOMAIN_INFO結構的指標。 |
|
設定 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 |