ManagementObject.InvokeMethod Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Methode für das Objekt auf.
Überlädt
| Name | Beschreibung |
|---|---|
| InvokeMethod(String, Object[]) |
Ruft eine Methode für das Objekt auf. |
| InvokeMethod(ManagementOperationObserver, String, Object[]) |
Ruft eine Methode für das Objekt asynchron auf. |
| InvokeMethod(String, ManagementBaseObject, InvokeMethodOptions) |
Ruft eine Methode für das WMI-Objekt auf. Die Eingabe- und Ausgabeparameter werden als ManagementBaseObject Objekte dargestellt. |
| InvokeMethod(ManagementOperationObserver, String, ManagementBaseObject, InvokeMethodOptions) |
Ruft eine Methode für das Objekt asynchron auf. |
InvokeMethod(String, Object[])
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
Ruft eine Methode für das Objekt auf.
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
Parameter
- methodName
- String
Der Name der auszuführenden Methode.
- args
- Object[]
Ein Array, das Parameterwerte enthält.
Gibt zurück
Der von der Methode zurückgegebene Objektwert.
Beispiele
Im folgenden Beispiel wird die Win32_Process::Create-Methode aufgerufen, um einen neuen Prozess von Notepad.exezu starten.
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
Hinweise
Wenn die Methode statisch ist, sollte die Ausführung trotzdem erfolgreich ausgeführt werden.
.NET Framework-Sicherheit
Volle Vertrauenswürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
InvokeMethod(ManagementOperationObserver, String, Object[])
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
Ruft eine Methode für das Objekt asynchron auf.
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())
Parameter
- watcher
- ManagementOperationObserver
Das Objekt, das die Ergebnisse des Vorgangs empfängt.
- methodName
- String
Der Name der auszuführenden Methode.
- args
- Object[]
Ein Array, das Parameterwerte enthält.
Hinweise
Wenn die Methode statisch ist, sollte die Ausführung trotzdem erfolgreich ausgeführt werden.
.NET Framework-Sicherheit
Volle Vertrauenswürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
InvokeMethod(String, ManagementBaseObject, InvokeMethodOptions)
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
Ruft eine Methode für das WMI-Objekt auf. Die Eingabe- und Ausgabeparameter werden als ManagementBaseObject Objekte dargestellt.
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
Parameter
- methodName
- String
Der Name der auszuführenden Methode.
- inParameters
- ManagementBaseObject
Eine ManagementBaseObject , die die Eingabeparameter an die Methode hält.
- options
- InvokeMethodOptions
Eine InvokeMethodOptions mit zusätzlichen Optionen für die Ausführung der Methode.
Gibt zurück
A ManagementBaseObject mit den Ausgabeparametern und dem Rückgabewert der ausgeführten Methode.
Beispiele
Im folgenden Beispiel wird die Win32_Process::Create-Methode aufgerufen, um einen neuen Prozess von Calc.exezu starten.
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
Hinweise
.NET Framework-Sicherheit
Volle Vertrauenswürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.
Gilt für:
InvokeMethod(ManagementOperationObserver, String, ManagementBaseObject, InvokeMethodOptions)
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
- Quelle:
- ManagementObject.cs
Ruft eine Methode für das Objekt asynchron auf.
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)
Parameter
- watcher
- ManagementOperationObserver
A ManagementOperationObserver used to handle the asynchron execution's progress and results.
- methodName
- String
Der Name der auszuführenden Methode.
- inParameters
- ManagementBaseObject
A ManagementBaseObject mit den Eingabeparametern für die Methode.
- options
- InvokeMethodOptions
Eine InvokeMethodOptions mit zusätzlichen Optionen, die zum Ausführen der Methode verwendet werden.
Hinweise
Die Methode ruft die angegebene Methodenausführung auf und gibt dann zurück. Der Fortschritt und die Ergebnisse werden über Ereignisse im ManagementOperationObserverBericht gemeldet.
.NET Framework-Sicherheit
Volle Vertrauenswürdigstellung für den unmittelbaren Anrufer. Dieses Element kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigen Code.