CIM_Directory クラスの TakeOwnerShipEx メソッド

  • [アーティクル]

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

重要

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

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

構文

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

パラメーター

StopFileName [out]

メソッドが失敗したファイル (またはディレクトリ) の名前を表す文字列。 メソッドが成功した場合、このパラメーターは null です。

StartFileName [in]

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

Recursive [in]

True の場合、メソッドは、CIM_Directory インスタンスで指定されたディレクトリ内のファイルとディレクトリに再帰的に適用されます。 ファイル インスタンスの場合、このパラメーターは無視されます。

戻り値

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

0

正常終了しました。

2

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

8

未指定のエラー。

9

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

10

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

11

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

12

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

13

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

14

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

15

共有違反です。

16

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

17

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

21

無効なパラメーター。

注釈

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

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

例

次の Visual Basic スクリプト コードは 、TakeOwnerShipEx メソッドを呼び出して、C:\temp フォルダーの所有権を取得します。

strComputer = "." 
Set objWMIService = GetObject( _
    "winmgmts:\\" & strComputer & "\root\CIMV2") 
' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")
' Obtain an InParameters object specific
' to the method.
Set objInParam = objShare.Methods_("TakeOwnerShipEx"). _
    inParameters.SpawnInstance_()

' Add the input parameters.
objInParam.Properties_.Item("Recursive") =  true

' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod( _
    "Win32_Directory.Name='C:\Temp'", "TakeOwnerShipEx", objInParam)
wscript.echo objOutParams.ReturnValue

要件

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

こちらもご覧ください

CIM_Directory

CIM_Directory