Win32_Directory 類別的 ChangeSecurityPermissions 方法

  • 發行項

ChangeSecurityPermissions WMI 類別方法會變更物件路徑中指定的邏輯目錄專案檔案的安全性許可權。 如果邏輯檔案是目錄， 則 ChangeSecurityPermissions 會遞迴，並變更目錄包含之所有檔案和子目錄的安全性許可權。 ChangeSecurityPermissions類別會傳回整數值 0 (零，如果許可權變更，則傳回 0) ，並傳回不同的數位來表示錯誤。

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

語法

uint32 ChangeSecurityPermissions(
  [in] Win32_SecurityDescriptor SecurityDescriptor,
  [in] uint32                   Option
);

參數

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) 變更系統存取控制清單。

傳回值

如果許可權已變更，則傳回值為 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