CIM_DataFile 類別的 ChangeSecurityPermissionsEx 方法

ChangeSecurityPermissionsEx方法會變更物件路徑中指定的邏輯資料檔案的安全性許可權， (此方法是ChangeSecurityPermissions方法的擴充版本) 。 如果邏輯檔案實際上是目錄，則此方法會以遞迴方式執行，變更目錄包含之所有檔案和子目錄的安全性許可權。

重要

DMTF (分散式管理工作組) CIM (Common Information Model) 類別是 WMI 類別建置所在的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。

本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫 方法。

語法

uint32 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32                   Option,
  [out]          string                   StopFileName,
  [in, optional] string                   StartFileName,
  [in, optional] boolean                  Recursive
);

參數

SecurityDescriptor [in]

指定安全性資訊。

注意

SECURITY_DESCRIPTOR結構中的Null ACL 會授與無限制存取權。 如需無限制存取含意的詳細資訊，請參閱 為新物件建立安全性描述元。

選項 [in]

要修改的安全性許可權。 例如，若要變更擁有者和 DACL 安全性，請使用：

Option = 1 + 4 或 Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

CHANGE_OWNER_SECURITY_INFORMATION (1)

變更邏輯檔案的擁有者。

CHANGE_GROUP_SECURITY_INFORMATION (2)

變更邏輯檔案的群組。

CHANGE_DACL_SECURITY_INFORMATION (4)

變更邏輯檔案的 ACL。

CHANGE_SACL_SECURITY_INFORMATION (8)

變更邏輯檔案的系統 ACL。

StopFileName [out]

字串，表示方法失敗之檔案的名稱 (或目錄) 。 如果方法成功，此參數為 null 。

StartFileName [in， optional]

字串，表示要作為此方法起點的子檔案 (或目錄) 。 一般而言， StartFileName 參數是 StopFileName 參數，指定先前方法呼叫發生錯誤的檔案或目錄。 如果此參數為 null，則會在 ExecMethod 呼叫中指定的檔案上執行作業 (或目錄) 。

如果使用 StartFileName ， 則 Recursive 也必須設定為 true。

遞迴 [in， 選擇性]

如果 為 True，方法也會以遞迴方式套用至 CIM_DataFile 實例所指定目錄中的檔案和目錄。 如果是檔案實例，則會忽略此參數。

傳回值

傳回值 0 (零) 成功，以及任何其他數位表示錯誤。 如需其他錯誤碼，請參閱 WMI 錯誤常數 或 WbemErrorEnum。 如需一般 HRESULT 值，請參閱 系統錯誤碼。

「成功」

0

成功。

拒絕存取

2

拒絕存取。

未指定的失敗

8

未指定的失敗。

不正確物件

9

指定的物件名稱無效。

物件已經存在

10

物件已存在。

檔案系統不是 NTFS

11

檔案系統不是 NTFS。

平臺不是 NT/Windows 2000

12

平臺不是 Windows。

磁片磁碟機不相同

13

磁片磁碟機不相同。

目錄非空白

14

目錄未清空。

共用違規

15

共用違規。

不正確起始檔案

16

啟動檔案無效。

未保留的許可權

17

未保留的許可權。

參數不正確

21

參數無效。

備註

CIM_DataFile中的ChangeSecurityPermissionsEx方法是由 WMI 實作。

本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
命名空間	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

CIM_DataFile

CIM_DataFile

WMI 工作：檔案和資料夾

檔案和目錄存取權限常數