共用方式為


CIM_LogicalFile 類別的 ChangeSecurityPermissionsEx 方法

ChangeSecurityPermissionsEx方法會變更物件路徑中指定的邏輯檔案安全性許可權, (此方法是ChangeSecurityPermissions方法) 的擴充版本。 如果邏輯檔案是目錄,則這個方法會以遞迴方式運作,變更目錄包含之所有檔案和子目錄的安全性許可權。

重要

DMTF (Distributed Management Task Force) 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]

指定安全性資訊。

選項 [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 呼叫中指定的檔案或目錄上執行。

遞迴 [in, 選擇性]

如果為 TRUE,則安全性許可權會以遞迴方式套用至 CIM_LogicalFile 實例所指定目錄中的檔案和目錄。 如果是檔案實例,則會忽略此參數。

傳回值

傳回值 0 (零) 成功,並傳回任何其他數位來表示錯誤。

「成功」

0

成功。

拒絕存取

2

拒絕存取。

未指定的失敗

8

未指定的失敗。

不正確物件

9

不正確物件。

物件已經存在

10

物件已存在。

檔案系統不是 NTFS

11

檔案系統不是 NTFS。

平臺不是 NT/Windows 2000

12

平臺不是 Windows。

磁片磁碟機不同

13

磁片磁碟機不同。

目錄非空白

14

目錄未清空。

共用違規

15

共用違規。

不正確啟動檔案

16

不正確啟動檔案。

未保留的許可權

17

未保留許可權。

參數不正確

21

無效的參數。

備註

WMI 目前未實作這個方法。 若要使用此方法,您必須在自己的提供者中實作此方法。

規格需求

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

另請參閱

CIM_LogicalFile

CIM_LogicalFile