Win32_Directory クラスの ChangeSecurityPermissions メソッド

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

このトピックでは、マネージド オブジェクト形式 (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 (ゼロ) の値を返し、エラーを示す別の数値を返します。

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