Win32_PageFile クラスの TakeOwnerShipEx メソッド

TakeOwnerShipExWMI クラス メソッドは、オブジェクト パスで指定された論理ページング ファイルの所有権を取得します。 このメソッドは 、TakeOwnerShip メソッドの拡張バージョンです。 論理ファイルが実際にはディレクトリである場合、このメソッドは再帰的に動作し、ディレクトリに含まれるすべてのファイルとサブディレクトリの所有権を取得します。

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

構文

uint32 TakeOwnerShipEx(
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

パラメーター

StopFileName [out]

TakeOwnerShipEx メソッドが失敗したファイルまたはディレクトリの名前。 メソッドが成功した場合、このパラメーターは null になります。

StartFileName [in, optional]

TakeOwnerShipEx の開始点として使用する子ファイルまたはディレクトリに名前を付けます。StartFileName パラメーターは、通常、前のメソッド呼び出しでエラーが発生したファイルまたはディレクトリを指定する StopFileName パラメーターです。 このパラメーターが NULL の場合、ExecMethod 呼び出しで指定されたファイルまたはディレクトリに対して操作が実行されます。

Recursive [in, optional]

true の場合、所有権の変更は、CIM_LogicalFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリに再帰的に適用されます。

注意

ファイル インスタンスの場合、 Recursive パラメーターは無視されます。

戻り値

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

0

要求は成功しました。

2

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

8

指定されていないエラーが発生しました。

9

指定された名前が無効です。

"10"

指定されたオブジェクトは既に存在します。

11

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

12

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

13

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

14

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

15

共有違反が発生しました。

16

指定された開始ファイルが無効です。

17

操作に必要な特権は保持されません。

21

指定されたパラメーターが無効です。

要件

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

こちらもご覧ください

オペレーティング システム クラス

Win32_PageFile