[This is preliminary documentation and subject to change.]
Use the IWbemLocator interface to obtain the initial namespace pointer to the CIM Object Manager (CIMOM) on a particular host machine. You can access CIMOM itself using the IWbemServices pointer, which is returned by the ConnectServer method on this interface.
A client or provider that needs CIMOM services first obtains a pointer to the locator using CoCreateInstance or CoCreateInstanceEx, as specified in COM documentation in the Microsoft Platform SDK. The IWbemLocator object is always an in-process COM server. The interface pointer to the desired namespace on the desired target machine is then obtained through the IWbemLocator::ConnectServer method, the only method on this interface.
| IUnknown Methods | Description |
|---|---|
| QueryInterface | Determines if the current object supports a given interface. |
| AddRef | Increases the object's reference count by 1. |
| Release | Decrements the object's reference count, and frees the object when the reference count is zero. |
| IWbemLocator Methods | Description |
|---|---|
| ConnectServer | Connects to CIMOM on the specified machine. |