CIM_DeviceFile クラスの ChangeSecurityPermissionsEx メソッド

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

このトピックでは、マネージド オブジェクト形式 (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 は、無制限のアクセスを許可します。

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

戻り値

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

0

正常終了しました。

2

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

8

未指定のエラー。

9

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

10

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

11

ファイル システムは NTFS ではありません。

12

Windows ではなくプラットフォーム。

13

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

14

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

15

共有違反です。

16

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

17

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

21

無効なパラメーター。

注釈

現在、このメソッドは WMI によって実装されていません。 このメソッドを使用するには、独自のプロバイダーに実装する必要があります。

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

要件

関連項目

CIM_DeviceFile

CIM_DeviceFile