3.1.4.3 IWbemServices Interface
The IWbemServices interface exposes methods that MUST provide management services to client processes. The implementation MUST implement all methods and return errors if the semantics of the operation cannot be completed. IWbemServices defines the execution scope for all methods implemented on the interface. The initial scope MUST be established by the IWbemLevel1Login::NTLMLogin call, which returns the interface pointer.
Methods in RPC Opnum Order
|
Method |
Description |
|---|---|
|
Provides the client with an IWbemServices interface pointer that is scoped to the requested namespace. Opnum: 3 |
|
|
Cancels a currently pending asynchronous method call identified by the IWbemObjectSink pointer passed to the initial asynchronous method. Opnum: 4 |
|
|
Obtains a notification handler that allows the client to send events directly to the server. Opnum: 5 |
|
|
Retrieves a CIM class or a CIM instance. Opnum: 6 |
|
|
Asynchronous version of the IWbemServices::GetObject method. Opnum: 7 |
|
|
Creates a new class or updates an existing class in the namespace associated with the current IWbemServices interface. Opnum: 8 |
|
|
Asynchronous version of the IWbemServices::PutClass method. Opnum: 9 |
|
|
Deletes a specified class from the namespace associated with the current IWbemServices interface. Opnum: 10 |
|
|
Asynchronous version of the IWbemServices::DeleteClass method. Opnum: 11 |
|
|
Creates a class enumeration. Opnum: 12 |
|
|
Asynchronous version of the IWbemServices::CreateClassEnum method. Opnum: 13 |
|
|
Creates or updates an instance of an existing class. Opnum: 14 |
|
|
Asynchronous version of the PutInstance method. Opnum: 15 |
|
|
Deletes an instance of an existing class from the namespace that is pointed to by the IWbemServices interface object that is used to call the method. Opnum: 16 |
|
|
Asynchronous version of the IWbemServices::DeleteInstance method. Opnum: 17 |
|
|
Creates an instance enumeration of all class instances that satisfy the selection criteria. Opnum: 18 |
|
|
Asynchronous version of the IWbemServices::CreateInstanceEnum method. Opnum: 19 |
|
|
Returns an enumerable collection of IWbemClassObject interface objects based on a query. Opnum: 20 |
|
|
Asynchronous version of the IWbemServices::ExecQuery method. Opnum: 21 |
|
|
Server runs a query to receive events when called by a client to request subscription to the events. Opnum: 22 |
|
|
Asynchronous version of the IWbemServices::ExecNotificationQuery method. Opnum: 23 |
|
|
Executes a CIM method implemented by a CIM class or a CIM instance retrieved from the IWbemServices interface. Opnum: 24 |
|
|
Asynchronous version of the IWbemServices::ExecMethod method. Opnum: 25 |
IWbemServices MUST be a DCOM Remote Protocol interface. The interface MUST be uniquely identified by UUID {9556dc99-828c-11cf-a37e-00aa003240c7}. The object exporting this interface also implements the IWbemRefreshingServices interface, as shown in the following diagram.
Figure 5: The IWbemServices interface
For all methods, the server MUST increment CurrentRequestCount at the start of the method, and decrement it when returning from the method.
If IsServerPaused flag is set to True, the server MUST return WBEM_E_SERVER_TOO_BUSY if CurrentRequestCount is greater than MaxRequestLimit. The class names used in the operations MUST conform to the CLASS-NAME element of the WQL query. The server MUST treat class names in a case-insensitive manner.