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

2007-08-14

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

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

構文

'宣言
Public Sub New ( _
    context As ManagementNamedValueCollection, _
    timeout As TimeSpan _
)
'使用
Dim context As ManagementNamedValueCollection
Dim timeout As TimeSpan

Dim instance As New InvokeMethodOptions(context, timeout)

public InvokeMethodOptions (
    ManagementNamedValueCollection context,
    TimeSpan timeout
)

public:
InvokeMethodOptions (
    ManagementNamedValueCollection^ context, 
    TimeSpan timeout
)

public InvokeMethodOptions (
    ManagementNamedValueCollection context, 
    TimeSpan timeout
)

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

パラメータ

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

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

使用例

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

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

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