ManagementObject.InvokeMethod Method (String, ManagementBaseObject, InvokeMethodOptions)
.NET Framework 4
Invokes a method on the WMI object. The input and output parameters are represented as ManagementBaseObject objects.
Assembly: System.Management (in System.Management.dll)
public ManagementBaseObject InvokeMethod( string methodName, ManagementBaseObject inParameters, InvokeMethodOptions options )
Parameters
- methodName
- Type: System.String
The name of the method to execute.
- inParameters
- Type: System.Management.ManagementBaseObject
A ManagementBaseObject holding the input parameters to the method.
- options
- Type: System.Management.InvokeMethodOptions
An InvokeMethodOptions containing additional options for the execution of the method.
Return Value
Type: System.Management.ManagementBaseObjectA ManagementBaseObject containing the output parameters and return value of the executed method.
.NET Framework Security
Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
The following example invokes the Win32_Process::Create method to start a new process of 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"]); } }
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.