TreeResetNamedSecurityInfoA 函式 (aclapi.h)
不支援此函式的這個版本。 支援此函式的寬字元版本 TreeResetNamedSecurityInfoW。
語法
DWORD TreeResetNamedSecurityInfoA(
[in] LPSTR pObjectName,
[in] SE_OBJECT_TYPE ObjectType,
[in] SECURITY_INFORMATION SecurityInfo,
[in, optional] PSID pOwner,
[in, optional] PSID pGroup,
[in, optional] PACL pDacl,
[in, optional] PACL pSacl,
[in] BOOL KeepExplicit,
[in, optional] FN_PROGRESS fnProgress,
[in] PROG_INVOKE_SETTING ProgressInvokeSetting,
[in, optional] PVOID Args
);
參數
[in] pObjectName
Null 終止字串的指標，指定要接收更新安全性資訊之物件的根節點物件名稱。 支援的對象是登錄機碼和檔案物件。 如需不同物件類型的字串格式描述，請參閱 SE_OBJECT_TYPE。
[in] ObjectType
SE_OBJECT_TYPE列舉的值，指出 pObjectName 參數所命名的物件類型。 針對登錄機碼和檔案對象，支援的值為SE_REGISTRY_KEY和SE_FILE_OBJECT。
[in] SecurityInfo
一組位旗標，指出要重設的安全性信息類型。 此參數可以是 SECURITY_INFORMATION 位旗標的組合。
[in, optional] pOwner
識別物件擁有者 之 SID 結構的指標。 SID 必須是可指派為安全性描述元擁有者 SID 的 SID。 SecurityInfo 參數必須包含 OWNER_SECURITY_INFORMATION 旗標。 若要設定擁有者，呼叫端必須具有每個物件的WRITE_OWNER存取權，包括根物件。 如果您未設定擁有者 SID，此參數可以是 NULL。
[in, optional] pGroup
識別物件主要群組之 SID 結構的指標。 SecurityInfo 參數必須包含 GROUP_SECURITY_INFORMATION 旗標。 若要設定群組，呼叫端必須具有每個物件的WRITE_OWNER存取權，包括根物件。 如果您未設定主要群組 SID，此參數可以是 NULL。
[in, optional] pDacl
訪問控制清單的指標 (ACL) 結構，代表要重設之物件的新 DACL。 SecurityInfo 參數必須包含 DACL_SECURITY_INFORMATION 旗標。 呼叫端必須具有每個物件的READ_CONTROL和WRITE_DAC存取權，包括根物件。 如果您未設定 DACL，此參數可以是 NULL。
[in, optional] pSacl
ACL 結構的指標，表示要重設之物件的新 SACL。 SecurityInfo 參數必須包含下列任何旗標：SACL_SECURITY_INFORMATION、LABEL_SECURITY_INFORMATION、ATTRIBUTE_SECURITY_INFORMATION、SCOPE_SECURITY_INFORMATION或BACKUP_SECURITY_INFORMATION。 如果設定SACL_SECURITY_INFORMATION或SCOPE_SECURITY_INFORMATION，呼叫端必須啟用SE_SECURITY_NAME許可權。 如果您未設定 SACL，此參數可以是 NULL。
[in] KeepExplicit
布爾值，定義是否保留或刪除子樹狀結構的明確定義 ACE。 如果 KeepExplicit 為 TRUE，則會針對每個子樹 DACL 和 SACL 保留明確定義的 ACE，而繼承的 ACE 會由 pDacl 和 pSacl 繼承的 ACE 取代。 如果 KeepExplicit 為 FALSE，則會先刪除每個子樹 DACL 和 SACL 的 ACE，再從 pDacl 和 pSacl 取代繼承的 ACE。
[in, optional] fnProgress
用來追蹤 TreeResetNamedSecurityInfo 函式進度之函式的指標。 進度函式的原型為：
#include <windows.h>
#include <Aclapi.h>
typedef VOID (*FN_PROGRESS) (
IN LPWSTR pObjectName, // Name of object just processed
IN DWORD Status, // Status of operation on object
IN OUT PPROG_INVOKE_SETTING pInvokeSetting, // When to set
IN PVOID Args, // Caller specific data
IN BOOL SecuritySet // Whether security was set
);
進度函式會在處理節點時，提供呼叫端的進度和錯誤資訊。 呼叫端會指定 fnProgress 中的進度函式，並在樹狀結構作業期間， TreeResetNamedSecurityInfo 會傳遞最後一個處理對象的名稱、該作業的錯誤狀態，以及目前的PROG_INVOKE_SETTING值。 呼叫端可以使用 pInvokeSetting 來變更PROG_INVOKE_SETTING值。
如果未使用任何進度函式，請將此參數設定為 NULL。
[in] ProgressInvokeSetting
指定進度函式初始設定 的 PROG_INVOKE_SETTING 列舉值。
[in, optional] Args
呼叫端所指定之 PROGRESS 函式自變數的 VOID 指標。
傳回值
如果函式成功，函式會傳回ERROR_SUCCESS。
如果函式失敗，它會傳回 WinError.h 中定義的錯誤碼。
備註
此函式不支援設定 NULL 擁有者、群組、DACL 或 SACL。
如果呼叫端不包含適當的許可權和許可權，以支援要求的擁有者、群組、DACL 和 SACL 更新，則不會執行任何更新。
此函式類似於 TreeSetNamedSecurityInfo 函式：
- 如果 TreeResetNamedSecurityInfo 的 KeepExplicit 參數設定為 TRUE，則函式相當於 TreeSetNamedSecurityInfo，並將 dwAction 參數設定為 TREE_SEC_INFO_RESET_KEEP_EXPLICIT。
- 如果 TreeResetNamedSecurityInfo 的 KeepExplicit 參數設定為 FALSE，則函式相當於 TreeSetNamedSecurityInfo，並將 dwAction 參數設定為 TREE_SEC_INFO_RESET。
注意
aclapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 TreeResetNamedSecurityInfo 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | aclapi.h |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |