InvokeMethodOptions Clase

Referencia

Definición

Espacio de nombres:: System.Management

Ensamblado:: System.Management.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Especifica opciones para invocar un método de administración.

public ref class InvokeMethodOptions : System::Management::ManagementOptions

public class InvokeMethodOptions : System.Management.ManagementOptions

type InvokeMethodOptions = class
    inherit ManagementOptions

Public Class InvokeMethodOptions
Inherits ManagementOptions

Herencia: Object

ManagementOptions
InvokeMethodOptions

Ejemplos

En el ejemplo siguiente se invoca el método Win32_Process::Create para iniciar un nuevo proceso de Calc.exe. La InvokeMethodOptions clase se usa para invocar el método .

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"]);
    }
}

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

Constructores

InvokeMethodOptions()	Inicializa una nueva instancia de la clase InvokeMethodOptions para la operación InvokeMethod(String, Object[]), mediante los valores predeterminados. Este es el constructor sin parámetros.
InvokeMethodOptions(ManagementNamedValueCollection, TimeSpan)	Inicializa una nueva instancia de la clase InvokeMethodOptions para una operación de invocación mediante los valores especificados.

Propiedades

Context

Obtiene o establece un objeto de contexto WMI. Se trata de una lista de pares de nombre y valor que se pasa a un proveedor WMI que admita información de contexto para las operaciones personalizadas.

(Heredado de ManagementOptions)

Timeout

Obtiene o establece el tiempo de espera que se aplicará a la operación. Observe que, en el caso de las operaciones que devuelvan colecciones, este tiempo de espera se aplica a la enumeración a través de la colección resultante y no a la operación en sí (para esta última se usa la propiedad ReturnImmediately). Esta propiedad se utiliza para indicar que la operación se debe realizar semisincrónicamente.