InvokeMethodOptions Classe

Definição

Namespace:

System.Management

Assembly:

System.Management.dll

Pacote:

System.Management v8.0.0

Origem:

ManagementOptions.cs

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

Object

ManagementOptions

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)