CIM_DataFile クラスの ChangeSecurityPermissions メソッド

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

重要

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

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

構文

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

パラメーター

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 を変更します。

戻り値

成功した場合は 0、エラーを示すその他の数値を返します。 その他のエラー コードについては、「 WMI エラー定数」 または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

Success

0

正常終了しました。

アクセスが拒否されました

2

アクセスが拒否されました。

不特定のエラー

8

指定されていないエラー。

無効なオブジェクト

9

オブジェクトが無効です。

オブジェクトは既に存在します

10

オブジェクトは既にあります。

ファイル システムが NTFS ではない

11

NT/Windows 2000 以外のプラットフォーム

12

プラットフォームはWindows NTベースではありません。

ドライブが同じではない

13

ドライブが同じではありません。

ディレクトリが空ではない

14

ディレクトリは空ではありません。

共有違反

15

共有違反です。

開始ファイルが無効です

16

開始ファイルが無効です。

特権が保持されていません

17

特権が保持されていません。

パラメーターが無効です

21

無効なパラメーター。

解説

CIM_DataFileの ChangeSecurityPermissions メソッドは WMI によって実装されます。

このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

関連項目

CIM_DataFile

CIM_DataFile

WMI タスク: ファイルとフォルダー

ファイルとディレクトリのアクセス権の定数