Win32_Directory クラスの ChangeSecurityPermissionsEx メソッド

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

このトピックでは、マネージド オブジェクト形式 (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のインスタンスに対する新しいセキュリティ アクセス許可 が含まれています。

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)

論理ファイルの DACL リストを変更します。

CHANGE_SACL_SECURITY_INFORMATION (8)

論理ファイルのシステム・アクセス制御リスト (SACL) を変更します。

StopFileName [out]

ChangeSecurityPermissionsEx メソッドが失敗したファイルまたはディレクトリの名前。 メソッドが成功した場合、このパラメーターは null です。

StartFileName [in, optional]

ChangeSecurityPermissionsEx の開始点として使用する子ファイルまたはディレクトリに名前を付けます。 通常、 StartFileName パラメーターは StopFileName パラメーターであり、前のメソッド呼び出しでエラーが発生したファイルまたはディレクトリを指定します。 このパラメーターが null の場合、 ExecMethod 呼び出しで指定されたファイルまたはディレクトリに対して操作が実行されます。 このパラメーターは省略可能です。

StartFileName を使用する場合は、Recursive も true に設定する必要があります。

Recursive [in, optional]

true の場合、所有権の変更は、CIM_LogicalFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリに再帰的に適用されます。 ファイル インスタンスの場合、 Recursive 入力パラメーターは無視されます。 このパラメーターは省略できます。

戻り値

アクセス許可が変更された場合は 0 (ゼロ) の値を返し、エラーを示す別の数値を返します。

Success

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