CIM_LogicalFile 類別的 ChangeSecurityPermissions 方法

  • 發行項

ChangeSecurityPermissions方法會變更物件路徑中所指定邏輯檔案的安全性許可權。 如果邏輯檔案是目錄， 則 ChangeSecurityPermissions 會以遞迴方式採取行動，變更目錄包含之所有檔案和子目錄的安全性許可權。

重要

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

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

語法

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

參數

SecurityDescriptor [in]

指定安全性資訊。

注意

SECURITY_DESCRIPTOR授與無限制存取權的ACL (ACL) Null存取控制清單。

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

傳回值

傳回成功時為 0 的值，以及指出錯誤的任何其他數位。

「成功」

0

成功。

拒絕存取

2

拒絕存取。

未指定的失敗

8

未指定的失敗。

不正確物件

9

不正確物件。

物件已經存在

10

物件已存在。

檔案系統不是 NTFS

11

檔案系統不是 NTFS。

平臺不是 NT/Windows 2000

12

平臺不是 Windows。

磁片磁碟機不相同

13

磁片磁碟機不相同。

目錄非空白

14

目錄未清空。

共用違規

15

共用違規。

不正確起始檔案

16

不正確起始檔案。

未保留的許可權

17

未保留的許可權。

參數不正確

21

無效的參數。

備註

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

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

規格需求

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

另請參閱

CIM_LogicalFile

CIM_LogicalFile