InvokeMethodOptions Classe

Definição

Especifica opções para invocar um método de gestão.

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 seguinte 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

Name Description
InvokeMethodOptions()

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

InvokeMethodOptions(ManagementNamedValueCollection, TimeSpan)

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

Propriedades

Name Description
Context

Obtém ou define um objeto de contexto WMI. Esta é uma lista de pares nome-valor a ser passada para um fornecedor WMI que suporta informação de contexto para operação personalizada.

(Herdado de ManagementOptions)
Timeout

Obtém ou define o time-out para aplicar à operação. Note que, para operações que retornam coleções, este time-out aplica-se à enumeração através da coleção resultante, não à operação em si (a ReturnImmediately propriedade é usada para esta última). Esta propriedade é usada para indicar que a operação deve ser realizada de forma semi-síncrona.

(Herdado de ManagementOptions)

Métodos

Name Description
Clone()

Devolve uma cópia do objeto.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a