InvokeMethodOptions Classe

Definição

Especifica as opções para invocar um método de gerenciamento.Specifies options for invoking a management method.

public ref class InvokeMethodOptions : System::Management::ManagementOptions
public class InvokeMethodOptions : System.Management.ManagementOptions
type InvokeMethodOptions = class
    inherit ManagementOptions
Public Class InvokeMethodOptions
Inherits ManagementOptions
Herança
InvokeMethodOptions

Exemplos

O exemplo a seguir invoca o método Win32_Process:: Create para iniciar um novo processo de Calc. exe.The following example invokes the Win32_Process::Create method to start a new process of Calc.exe. A InvokeMethodOptions classe é usada para invocar o método.The InvokeMethodOptions class is used to invoke the method.

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

Construtores

InvokeMethodOptions()

Inicializa uma nova instância da classe InvokeMethodOptions para a operação InvokeMethod(String, Object[]), usando valores padrão.Initializes a new instance of the InvokeMethodOptions class for the InvokeMethod(String, Object[]) operation, using default values. Esse é o construtor sem parâmetros.This is the parameterless constructor.

InvokeMethodOptions(ManagementNamedValueCollection, TimeSpan)

Inicializa uma nova instância da classe InvokeMethodOptions para uma operação de invocação, usando os valores especificados.Initializes a new instance of the InvokeMethodOptions class for an invoke operation using the specified values.

Propriedades

Context

Obtém ou define um objeto de contexto WMI.Gets or sets a WMI context object. Essa é uma lista de pares nome-valor a ser passada para um provedor WMI que dá suporte a informações de contexto para a operação personalizada.This is a name-value pairs list to be passed through to a WMI provider that supports context information for customized operation.

(Herdado de ManagementOptions)
Timeout

Obtém ou define o tempo limite para aplicar a operação.Gets or sets the time-out to apply to the operation. Observe que, para operações que retornam coleções, esse tempo limite se aplica à enumeração por meio da coleção resultante, não da operação propriamente dita (a propriedade ReturnImmediately é usada para a operação).Note that for operations that return collections, this time-out applies to the enumeration through the resulting collection, not the operation itself (the ReturnImmediately property is used for the latter). Essa propriedade é usada para indicar que a operação deve ser realizada de forma semissíncrona.This property is used to indicate that the operation should be performed semi-synchronously.

(Herdado de ManagementOptions)

Métodos

Clone()

Retorna uma cópia do objeto.Returns a copy of the object.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a