Win32_Directory 類別的 ChangeSecurityPermissionsEx 方法

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

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

語法

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

參數

SecurityDescriptor [in]

解析為 Win32_SecurityDescriptor實例的運算式。 此參數包含 Win32_PageFile實例的新安全性許可權。

選項 [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)

變更邏輯檔案的 DACL 清單。

CHANGE_SACL_SECURITY_INFORMATION (8)

(邏輯檔案的 SACL) 變更系統存取控制清單。

StopFileName [out]

ChangeSecurityPermissionsEx方法失敗的檔案或目錄名稱。 如果方法成功，此參數為 null。

StartFileName [in， optional]

將子檔案或目錄命名為 ChangeSecurityPermissionsEx的起點。 一般而言， StartFileName 參數是 StopFileName 參數，指定先前方法呼叫發生錯誤的檔案或目錄。 如果此參數為 null，則會在 ExecMethod 呼叫中指定的檔案或目錄上執行作業。 這是選擇性參數。

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

遞迴 [in， 選擇性]

如果 為 true，則以遞迴方式將擁有權變更套用至 CIM_LogicalFile 實例所指定目錄中的檔案和目錄。 對於檔案實例，會忽略 遞迴 輸入參數。 這是選擇性參數。

傳回值

如果許可權已變更，則傳回值為 0 (零) ，並傳回不同的數位來表示錯誤。

「成功」

0

要求成功。

拒絕存取

2

存取遭到拒絕。

未指定的失敗

8

發生未指定的失敗。

不正確物件

9

指定的名稱無效。

物件已經存在

10

指定的物件已存在。

檔案系統不是 NTFS

11

檔案系統不是 NTFS 檔案系統。

平臺不是 NT/Windows 2000

12

平臺不是 Windows。

磁片磁碟機不相同

13

磁片磁碟機不相同。

目錄非空白

14

目錄不是空的。

共用違規

15

共用違規。

不正確起始檔案

16

指定的啟動檔案無效。

未保留的許可權

17

作業所需的許可權不會保留。

參數不正確

21

指定的參數無效。

規格需求

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

另請參閱

作業系統類別

Win32_Directory