ManagementObject.InvokeMethod Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Invoca um método no objeto.
Sobrecargas
| Name | Description |
|---|---|
| InvokeMethod(String, Object[]) |
Invoca um método no objeto. |
| InvokeMethod(ManagementOperationObserver, String, Object[]) |
Invoca um método no objeto, assíncrono. |
| InvokeMethod(String, ManagementBaseObject, InvokeMethodOptions) |
Invoca um método no objeto WMI. Os parâmetros de entrada e saída são representados como ManagementBaseObject objetos. |
| InvokeMethod(ManagementOperationObserver, String, ManagementBaseObject, InvokeMethodOptions) |
Invoca um método no objeto, assíncrono. |
InvokeMethod(String, Object[])
Invoca um método no objeto.
public:
System::Object ^ InvokeMethod(System::String ^ methodName, cli::array <System::Object ^> ^ args);
public object InvokeMethod(string methodName, object[] args);
member this.InvokeMethod : string * obj[] -> obj
Public Function InvokeMethod (methodName As String, args As Object()) As Object
Parâmetros
- methodName
- String
O nome do método a executar.
- args
- Object[]
Um array contendo valores de parâmetros.
Devoluções
O valor do objeto devolvido pelo método.
Exemplos
O exemplo seguinte invoca o método Win32_Process::Create para iniciar um novo processo de Notepad.exe.
using System;
using System.Management;
// This sample demonstrates invoking
// a WMI method using an array of arguments.
public class InvokeMethod
{
public static void Main()
{
// Get the object on which the
// method will be invoked
ManagementClass processClass =
new ManagementClass("Win32_Process");
// Create an array containing all
// arguments for the method
object[] methodArgs =
{"notepad.exe", null, null, 0};
//Execute the method
object result =
processClass.InvokeMethod(
"Create", methodArgs);
//Display results
Console.WriteLine(
"Creation of process returned: " + result);
Console.WriteLine("Process id: " + methodArgs[3]);
}
}
Imports System.Management
' This sample demonstrates invoking a WMI method
' using an array of arguments.
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("Win32_Process")
' Create an array containing all arguments
' for the method
Dim methodArgs() As Object = _
{"notepad.exe", Nothing, Nothing, 0}
' Execute the method
Dim result As Object = _
processClass.InvokeMethod("Create", methodArgs)
' Display results
Console.WriteLine( _
"Creation of process returned: {0}", result)
Console.WriteLine( _
"Process id: {0}", methodArgs(3))
Return 0
End Function
End Class
Observações
Se o método for estático, a execução deverá ser bem-sucedida.
Segurança do .NET Framework
Confiança total no contacto imediato. Este membro não pode ser utilizado por código parcialmente confiável. Para mais informações, consulte Utilização de Bibliotecas de Código Parcialmente Confiável.
Aplica-se a
InvokeMethod(ManagementOperationObserver, String, Object[])
Invoca um método no objeto, assíncrono.
public:
void InvokeMethod(System::Management::ManagementOperationObserver ^ watcher, System::String ^ methodName, cli::array <System::Object ^> ^ args);
public void InvokeMethod(System.Management.ManagementOperationObserver watcher, string methodName, object[] args);
member this.InvokeMethod : System.Management.ManagementOperationObserver * string * obj[] -> unit
Public Sub InvokeMethod (watcher As ManagementOperationObserver, methodName As String, args As Object())
Parâmetros
- watcher
- ManagementOperationObserver
O objetivo é receber os resultados da operação.
- methodName
- String
O nome do método a executar.
- args
- Object[]
Um array contendo valores de parâmetros.
Observações
Se o método for estático, a execução deverá ser bem-sucedida.
Segurança do .NET Framework
Confiança total no contacto imediato. Este membro não pode ser utilizado por código parcialmente confiável. Para mais informações, consulte Utilização de Bibliotecas de Código Parcialmente Confiável.
Aplica-se a
InvokeMethod(String, ManagementBaseObject, InvokeMethodOptions)
Invoca um método no objeto WMI. Os parâmetros de entrada e saída são representados como ManagementBaseObject objetos.
public:
System::Management::ManagementBaseObject ^ InvokeMethod(System::String ^ methodName, System::Management::ManagementBaseObject ^ inParameters, System::Management::InvokeMethodOptions ^ options);
public System.Management.ManagementBaseObject InvokeMethod(string methodName, System.Management.ManagementBaseObject inParameters, System.Management.InvokeMethodOptions options);
member this.InvokeMethod : string * System.Management.ManagementBaseObject * System.Management.InvokeMethodOptions -> System.Management.ManagementBaseObject
Public Function InvokeMethod (methodName As String, inParameters As ManagementBaseObject, options As InvokeMethodOptions) As ManagementBaseObject
Parâmetros
- methodName
- String
O nome do método a executar.
- inParameters
- ManagementBaseObject
A manter ManagementBaseObject os parâmetros de entrada do método.
- options
- InvokeMethodOptions
E contendo InvokeMethodOptions opções adicionais para a execução do método.
Devoluções
A contendo ManagementBaseObject os parâmetros de saída e o valor de retorno do método executado.
Exemplos
O exemplo seguinte invoca o método Win32_Process::Create para iniciar um novo processo de Calc.exe.
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";
// Execute the method
ManagementBaseObject outParams =
processClass.InvokeMethod ("Create",
inParams, null);
// 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("Win32_Process")
' Get an input parameters object for this method
Dim inParams As ManagementBaseObject = _
processClass.GetMethodParameters("Create")
' Fill in input parameter values
inParams("CommandLine") = "calc.exe"
' Execute the method
Dim outParams As ManagementBaseObject = _
processClass.InvokeMethod( _
"Create", inParams, Nothing)
' 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
Observações
Segurança do .NET Framework
Confiança total no contacto imediato. Este membro não pode ser utilizado por código parcialmente confiável. Para mais informações, consulte Utilização de Bibliotecas de Código Parcialmente Confiável.
Aplica-se a
InvokeMethod(ManagementOperationObserver, String, ManagementBaseObject, InvokeMethodOptions)
Invoca um método no objeto, assíncrono.
public:
void InvokeMethod(System::Management::ManagementOperationObserver ^ watcher, System::String ^ methodName, System::Management::ManagementBaseObject ^ inParameters, System::Management::InvokeMethodOptions ^ options);
public void InvokeMethod(System.Management.ManagementOperationObserver watcher, string methodName, System.Management.ManagementBaseObject inParameters, System.Management.InvokeMethodOptions options);
member this.InvokeMethod : System.Management.ManagementOperationObserver * string * System.Management.ManagementBaseObject * System.Management.InvokeMethodOptions -> unit
Public Sub InvokeMethod (watcher As ManagementOperationObserver, methodName As String, inParameters As ManagementBaseObject, options As InvokeMethodOptions)
Parâmetros
- watcher
- ManagementOperationObserver
A usado ManagementOperationObserver para tratar do progresso e dos resultados da execução assíncrona.
- methodName
- String
O nome do método a ser executado.
- inParameters
- ManagementBaseObject
A contendo ManagementBaseObject os parâmetros de entrada do método.
- options
- InvokeMethodOptions
E que InvokeMethodOptions contém opções adicionais usadas para executar o método.
Observações
O método invoca a execução especificada e depois retorna. O progresso e os resultados são reportados através de eventos no ManagementOperationObserver.
Segurança do .NET Framework
Confiança total no contacto imediato. Este membro não pode ser utilizado por código parcialmente confiável. Para mais informações, consulte Utilização de Bibliotecas de Código Parcialmente Confiável.