InvokeMethodOptions

.NET Framework クラス ライブラリ リファレンス

InvokeMethodOptions クラス

管理メソッドを呼び出すためのオプションを指定します。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文

Visual Basic (宣言)

Public Class InvokeMethodOptions
    Inherits ManagementOptions

Visual Basic (使用法)

Dim instance As InvokeMethodOptions

C#

public class InvokeMethodOptions : ManagementOptions

C++

public ref class InvokeMethodOptions : public
 ManagementOptions

J#

public class InvokeMethodOptions extends ManagementOptions

JScript

public class InvokeMethodOptions extends
 ManagementOptions

使用例

Win32_Process::Create メソッドを呼び出して、Calc.exe の新しいプロセスを開始する例を次に示します。このメソッドを呼び出すために InvokeMethodOptions クラスが使用されます。

Visual Basic

Imports System
Imports System.Management

' This sample demonstrates invoking
' a WMI method using parameter objects
Class InvokeMethod
    Public Overloads Shared
 Function _
        Main(ByVal args() As String)
 As Integer

        ' Get the object on which the
        ' method will be invoked
        Dim processClass As _
            New ManagementClass("root\CIMV2",
 _
            "Win32_Process", _
            Nothing)

        ' Get an input parameters object for this method
        Dim inParams As ManagementBaseObject
 = _
            processClass.GetMethodParameters("Create")

        ' Fill in input parameter values
        inParams("CommandLine") = "calc.exe"

        ' Method Options
        Dim methodOptions As New
 InvokeMethodOptions( _
            Nothing, System.TimeSpan.MaxValue)

        ' Execute the method
        Dim outParams As ManagementBaseObject
 = _
            processClass.InvokeMethod( _
            "Create", inParams, methodOptions)

        ' Display results
        ' Note: The return code of the method 
        ' is provided in the "returnValue" property
        ' of the outParams object
        Console.WriteLine( _
            "Creation of calculator process returned: {0}",
 _
            outParams("returnValue"))
        Console.WriteLine("Process ID: {0}", _
            outParams("processId"))

        Return 0
    End Function
End Class

C#

using System;
using System.Management;

// This sample demonstrates invoking 
// a WMI method using parameter objects
public class InvokeMethod 
{    
    public static void Main()
 
    {

        // Get the object on which the method will be invoked
        ManagementClass processClass = 
            new ManagementClass("Win32_Process");

        // Get an input parameters object for this method
        ManagementBaseObject inParams =
            processClass.GetMethodParameters("Create");

        // Fill in input parameter values
        inParams["CommandLine"] = "calc.exe";

        // Method Options
        InvokeMethodOptions methodOptions = new 
            InvokeMethodOptions(null, 
            System.TimeSpan.MaxValue);

        // Execute the method
        ManagementBaseObject outParams =
            processClass.InvokeMethod("Create",
            inParams, methodOptions);

        // Display results
        // Note: The return code of the method is
        // provided in the "returnValue" property
        // of the outParams object
        Console.WriteLine(
            "Creation of calculator process returned: "
            + outParams["returnValue"]);
        Console.WriteLine("Process ID: " 
            + outParams["processId"]);
    }
}

継承階層

System.Object
   System.Management.ManagementOptions
    System.Management.InvokeMethodOptions

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
InvokeMethodOptions メンバ
System.Management 名前空間

InvokeMethodOptions コンストラクタ ()

InvokeMethod(String,Object[]) 操作のための InvokeMethodOptions クラスの新しいインスタンスを、既定値を使用して初期化します。これは既定のコンストラクタです。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New InvokeMethodOptions

C#

public InvokeMethodOptions ()

C++

public:
InvokeMethodOptions ()

J#

public InvokeMethodOptions ()

JScript

public function InvokeMethodOptions ()

使用例

Win32_Process::Create メソッドを呼び出して、Calc.exe の新しいプロセスを開始する例を次に示します。InvokeMethodOptions クラスの既定コンストラクタが使用されます。

Visual Basic

Imports System
Imports System.Management

' This sample demonstrates invoking
' a WMI method using parameter objects
Class InvokeMethod
    Public Overloads Shared
 Function _
        Main(ByVal args() As String)
 As Integer

        ' Get the object on which the
        ' method will be invoked
        Dim processClass As _
            New ManagementClass("root\CIMV2",
 _
            "Win32_Process", _
            Nothing)

        ' Get an input parameters object for this method
        Dim inParams As ManagementBaseObject
 = _
            processClass.GetMethodParameters("Create")

        ' Fill in input parameter values
        inParams("CommandLine") = "calc.exe"

        ' Method Options
        Dim methodOptions As New
 InvokeMethodOptions
        methodOptions.Timeout = _
            System.TimeSpan.MaxValue

        ' Execute the method
        Dim outParams As ManagementBaseObject
 = _
            processClass.InvokeMethod( _
            "Create", inParams, methodOptions)

        ' Display results
        ' Note: The return code of the method 
        ' is provided in the "returnValue" property
        ' of the outParams object
        Console.WriteLine( _
            "Creation of calculator process returned: {0}",
 _
            outParams("returnValue"))
        Console.WriteLine("Process ID: {0}", _
            outParams("processId"))

        Return 0
    End Function
End Class

C#

using System;
using System.Management;

// This sample demonstrates invoking 
// a WMI method using parameter objects
public class InvokeMethod 
{    
    public static void Main()
 
    {

        // Get the object on which the method will be invoked
        ManagementClass processClass = 
            new ManagementClass("Win32_Process");

        // Get an input parameters object for this method
        ManagementBaseObject inParams =
            processClass.GetMethodParameters("Create");

        // Fill in input parameter values
        inParams["CommandLine"] = "calc.exe";

        // Method Options
        InvokeMethodOptions methodOptions = new 
            InvokeMethodOptions();
        methodOptions.Timeout = 
            System.TimeSpan.MaxValue;

        // Execute the method
        ManagementBaseObject outParams =
            processClass.InvokeMethod("Create",
            inParams, methodOptions);

        // Display results
        // Note: The return code of the method is
        // provided in the "returnValue" property
        // of the outParams object
        Console.WriteLine(
            "Creation of calculator process returned: "
            + outParams["returnValue"]);
        Console.WriteLine("Process ID: " 
            + outParams["processId"]);
    }
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
InvokeMethodOptions クラス
InvokeMethodOptions メンバ
System.Management 名前空間

InvokeMethodOptions コンストラクタ (ManagementNamedValueCollection, TimeSpan)

呼び出し操作のための InvokeMethodOptions クラスの新しいインスタンスを、指定した値を使用して初期化します。

名前空間: System.Management
アセンブリ: System.Management (system.management.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    context As ManagementNamedValueCollection, _
    timeout As TimeSpan _
)

Visual Basic (使用法)

Dim context As ManagementNamedValueCollection
Dim timeout As TimeSpan

Dim instance As New InvokeMethodOptions(context,
 timeout)

C#

public InvokeMethodOptions (
    ManagementNamedValueCollection context,
    TimeSpan timeout
)

C++

public:
InvokeMethodOptions (
    ManagementNamedValueCollection^ context, 
    TimeSpan timeout
)

J#

public InvokeMethodOptions (
    ManagementNamedValueCollection context, 
    TimeSpan timeout
)

JScript

public function InvokeMethodOptions (
    context : ManagementNamedValueCollection, 
    timeout : TimeSpan
)

パラメータ

context

プロバイダを通じて渡される、プロバイダ固有の名前と値のペアを表すオブジェクト。

timeout

タイムアウトが発生するまでに操作を継続できる時間の長さ。既定値は MaxValue です。このパラメータを設定すると、操作は半同期的に呼び出されます。

使用例

Win32_Process::Create メソッドを呼び出して、Calc.exe の新しいプロセスを開始する例を次に示します。このメソッドを呼び出すために InvokeMethodOptions クラスが使用されます。

Visual Basic

Imports System
Imports System.Management

' This sample demonstrates invoking
' a WMI method using parameter objects
Class InvokeMethod
    Public Overloads Shared
 Function _
        Main(ByVal args() As String)
 As Integer

        ' Get the object on which the
        ' method will be invoked
        Dim processClass As _
            New ManagementClass("root\CIMV2",
 _
            "Win32_Process", _
            Nothing)

        ' Get an input parameters object for this method
        Dim inParams As ManagementBaseObject
 = _
            processClass.GetMethodParameters("Create")

        ' Fill in input parameter values
        inParams("CommandLine") = "calc.exe"

        ' Method Options
        Dim methodOptions As New
 InvokeMethodOptions( _
            Nothing, System.TimeSpan.MaxValue)

        ' Execute the method
        Dim outParams As ManagementBaseObject
 = _
            processClass.InvokeMethod( _
            "Create", inParams, methodOptions)

        ' Display results
        ' Note: The return code of the method 
        ' is provided in the "returnValue" property
        ' of the outParams object
        Console.WriteLine( _
            "Creation of calculator process returned: {0}",
 _
            outParams("returnValue"))
        Console.WriteLine("Process ID: {0}", _
            outParams("processId"))

        Return 0
    End Function
End Class

C#

using System;
using System.Management;

// This sample demonstrates invoking 
// a WMI method using parameter objects
public class InvokeMethod 
{    
    public static void Main()
 
    {

        // Get the object on which the method will be invoked
        ManagementClass processClass = 
            new ManagementClass("Win32_Process");

        // Get an input parameters object for this method
        ManagementBaseObject inParams =
            processClass.GetMethodParameters("Create");

        // Fill in input parameter values
        inParams["CommandLine"] = "calc.exe";

        // Method Options
        InvokeMethodOptions methodOptions = new 
            InvokeMethodOptions(null, 
            System.TimeSpan.MaxValue);

        // Execute the method
        ManagementBaseObject outParams =
            processClass.InvokeMethod("Create",
            inParams, methodOptions);

        // Display results
        // Note: The return code of the method is
        // provided in the "returnValue" property
        // of the outParams object
        Console.WriteLine(
            "Creation of calculator process returned: "
            + outParams["returnValue"]);
        Console.WriteLine("Process ID: " 
            + outParams["processId"]);
    }
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
InvokeMethodOptions クラス
InvokeMethodOptions メンバ
System.Management 名前空間

InvokeMethodOptions コンストラクタ

オーバーロードの一覧

名前	説明
InvokeMethodOptions ()	InvokeMethod(String,Object[]) 操作のための InvokeMethodOptions クラスの新しいインスタンスを、既定値を使用して初期化します。これは既定のコンストラクタです。
InvokeMethodOptions (ManagementNamedValueCollection, TimeSpan)	呼び出し操作のための InvokeMethodOptions クラスの新しいインスタンスを、指定した値を使用して初期化します。

参照

関連項目

InvokeMethodOptions クラス
InvokeMethodOptions メンバ
System.Management 名前空間

InvokeMethodOptions プロパティ

パブリック プロパティ

	名前	説明
	Context	WMI (Windows Management Instrumentation) コンテキスト オブジェクトを取得または設定します。これは、カスタマイズされた操作のためのコンテキスト情報をサポートしている WMI プロバイダに渡す名前/値ペア リストです。 ( ManagementOptions から継承されます。)
	Timeout	操作に適用するタイムアウトを取得または設定します。コレクションを返す操作では、このタイムアウトはその操作自体ではなく、結果として得られるコレクションの列挙に適用されます。操作自体に適用するには、ReturnImmediately プロパティを使用します。このプロパティは、操作が半同期的に実行されることを示すために使用されます。 ( ManagementOptions から継承されます。)

参照

関連項目

InvokeMethodOptions クラス
System.Management 名前空間

InvokeMethodOptions メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Clone	オーバーライドされます。 オブジェクトのコピーを返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

InvokeMethodOptions クラス
System.Management 名前空間

InvokeMethodOptions メンバ

管理メソッドを呼び出すためのオプションを指定します。

InvokeMethodOptions データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	InvokeMethodOptions	オーバーロードされます。

パブリック プロパティ

	名前	説明
	Context	WMI (Windows Management Instrumentation) コンテキスト オブジェクトを取得または設定します。これは、カスタマイズされた操作のためのコンテキスト情報をサポートしている WMI プロバイダに渡す名前/値ペア リストです。 (ManagementOptions から継承されます。)
	Timeout	操作に適用するタイムアウトを取得または設定します。コレクションを返す操作では、このタイムアウトはその操作自体ではなく、結果として得られるコレクションの列挙に適用されます。操作自体に適用するには、ReturnImmediately プロパティを使用します。このプロパティは、操作が半同期的に実行されることを示すために使用されます。 (ManagementOptions から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Clone	オーバーライドされます。 オブジェクトのコピーを返します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

InvokeMethodOptions クラス
System.Management 名前空間