Win32_CodecFile クラスの ChangeSecurityPermissions メソッド
ChangeSecurityPermissionsWMI クラス メソッドは、オブジェクト パスで指定された論理コーデック ファイルのセキュリティアクセス許可を変更します。 論理ファイルがディレクトリの場合、 ChangeSecurityPermissions は再帰的であり、ディレクトリに含まれるすべてのファイルとサブディレクトリのセキュリティ アクセス許可を変更します。 ChangeSecurityPermissions は、アクセス許可が変更された場合は 0 (ゼロ) の整数値を返し、エラーを示す別の数値を返します。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 ChangeSecurityPermissions(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option
);
パラメーター
-
SecurityDescriptor [in]
-
Win32_SecurityDescriptor のインスタンスに解決される式。 この記述子には、Win32_CodecFile のインスタンスに対する新しいセキュリティ アクセス許可 が含まれています。
-
オプション [in]
-
変更するセキュリティ特権。 たとえば、所有者と随意アクセス制御リスト (DACL) のセキュリティを変更するには、次を使用します。
Option = 1 + 4
\- または -
Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION
-
CHANGE_OWNER_SECURITY_INFORMATION (1 (0x1))
-
論理ファイルの所有者を変更します。
-
CHANGE_GROUP_SECURITY_INFORMATION (2 (0x2))
-
論理ファイルのグループを変更します。
-
CHANGE_DACL_SECURITY_INFORMATION (4 (0x4))
-
論理ファイルの随意アクセス制御リスト (DACL) を変更します。
-
CHANGE_SACL_SECURITY_INFORMATION (8 (0x8))
-
論理ファイルのシステム・アクセス制御リスト (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 |
|
[DLL] |
|