Partilhar via


InvokeMethodOptions Classe

Definição

Especifica as opções para invocar um método de gerenciamento.

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. A InvokeMethodOptions classe é usada para invocar o 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

Construtores

InvokeMethodOptions()

Inicializa uma nova instância da classe InvokeMethodOptions para a operação InvokeMethod(String, Object[]), usando valores padrão. Esse é o construtor sem parâmetros.

InvokeMethodOptions(ManagementNamedValueCollection, TimeSpan)

Inicializa uma nova instância da classe InvokeMethodOptions para uma operação de invocação, usando os valores especificados.

Propriedades

Context

Obtém ou define um objeto de contexto WMI. 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.

(Herdado de ManagementOptions)
Timeout

Obtém ou define o tempo limite para aplicar a operação. 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). Essa propriedade é usada para indicar que a operação deve ser realizada de forma semissíncrona.

(Herdado de ManagementOptions)

Métodos

Clone()

Retorna uma cópia do objeto.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a