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
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
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 zu auszuführenden Methode.
- args
- Object[]
Ein Array mit Parameterwerten.
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 der Notepad.exe zu 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 dennoch erfolgreich sein.
.NET Framework-Sicherheit
Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Gilt für:
InvokeMethod(ManagementOperationObserver, String, Object[])
- 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 der Operation empfängt.
- methodName
- String
Der Name der zu auszuführenden Methode.
- args
- Object[]
Ein Array mit Parameterwerten.
Hinweise
Wenn die Methode statisch ist, sollte die Ausführung dennoch erfolgreich sein.
.NET Framework-Sicherheit
Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Gilt für:
InvokeMethod(String, ManagementBaseObject, InvokeMethodOptions)
- 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 zu auszuführenden Methode.
- inParameters
- ManagementBaseObject
Ein ManagementBaseObject mit den Eingabeparametern für die Methode.
- options
- InvokeMethodOptions
Ein InvokeMethodOptions mit zusätzlichen Optionen für die Ausführung der Methode.
Gibt zurück
Ein 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 der Calc.exe zu 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ürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Gilt für:
InvokeMethod(ManagementOperationObserver, String, ManagementBaseObject, InvokeMethodOptions)
- 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
Ein ManagementOperationObserver, mit dem der Status und die Ergebnisse der asynchronen Ausführung behandelt werden.
- methodName
- String
Der Name der auszuführenden Methode.
- inParameters
- ManagementBaseObject
Ein ManagementBaseObject mit den Eingabeparametern für die Methode.
- options
- InvokeMethodOptions
Ein InvokeMethodOptions mit zusätzlichen Optionen für die Ausführung der Methode.
Hinweise
Die -Methode ruft die angegebene Methodenausführung auf und gibt dann zurück. Fortschritt und Ergebnisse werden über Ereignisse im ManagementOperationObservergemeldet.
.NET Framework-Sicherheit
Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.