CIM_DataFile クラスの 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]
-
セキュリティ情報を指定します。
注意
SECURITY_DESCRIPTOR構造体の NULL ACL は、無制限のアクセスを許可します。 無制限アクセスの影響の詳細については、「 新しいオブジェクトのセキュリティ記述子の作成」を参照してください。
-
オプション [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 呼び出しで指定されたファイル (またはディレクトリ) に対して操作が実行されます。
StartFileName を使用する場合は、Recursive も true に設定する必要があります。
Recursive [in, optional]
True の場合、メソッドは、CIM_DataFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリにも再帰的に適用されます。 ファイル インスタンスの場合、このパラメーターは無視されます。
戻り値
成功した場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。 その他のエラー コードについては、「 WMI エラー定数」 または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。
-
Success
-
0
正常終了しました。
-
アクセスが拒否されました
-
2
アクセスが拒否されました。
-
不特定のエラー
-
8
指定されていないエラー。
-
無効なオブジェクト
-
9
指定されたオブジェクト名が無効です。
-
オブジェクトは既に存在します
-
10
オブジェクトは既にあります。
-
ファイル システムが NTFS ではない
-
11
ファイル システムは NTFS ではありません。
-
NT/Windows 2000 以外のプラットフォーム
-
12
プラットフォームは Windows ではありません。
-
ドライブが同じではない
-
13
ドライブが同じではありません。
-
ディレクトリが空ではない
-
14
ディレクトリは空ではありません。
-
共有違反
-
15
共有違反です。
-
開始ファイルが無効です
-
16
開始ファイルが無効です。
-
特権が保持されていません
-
17
特権が保持されていません。
-
パラメーターが無効です
-
21
パラメーターが無効です。
注釈
CIM_DataFileの ChangeSecurityPermissionsEx メソッドは WMI によって実装されます。
このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|