CIM_LogicalFile クラスの ChangeSecurityPermissionsEx メソッド

ChangeSecurityPermissionsEx メソッドは、オブジェクト パスで指定された論理ファイルのセキュリティ アクセス許可を変更します (このメソッドは ChangeSecurityPermissions メソッドの拡張バージョンです)。 論理ファイルがディレクトリの場合、このメソッドは再帰的に動作し、ディレクトリに含まれるすべてのファイルとサブディレクトリのセキュリティ アクセス許可を変更します。

重要

DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。

このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

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

パラメーター

SecurityDescriptor [in]

セキュリティ情報を指定します。

Option [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 呼び出しで指定されたファイルまたはディレクトリに対して操作が実行されます。

Recursive [in, optional]

TRUE の場合、セキュリティ アクセス許可は、CIM_LogicalFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリに再帰的に適用されます。 ファイル インスタンスの場合、このパラメーターは無視されます。

戻り値

成功した場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。

Success

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