IWbemLocator

IWbemLocator インターフェイスは、特定のホストコンピューター上の WMI に対する IWbemServices インターフェイスへの、最初の名前空間ポインターを取得するために使用します。

IWbemLocator::ConnectServer メソッドは、strNetworkResource パラメーターで指定されたコンピューター上の WMI 名前空間への接続を DCOM 経由で作成します。

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。HRESULT に含まれる値を次に示します。

ネットワークの問題によって WMI へのリモート接続が失われた場合は、COM 固有のエラーコードが返されることがあります。

これらのエラーの戻り値は、PSDK の \Include ディレクトリの WMI セクションにある Wbemcli.h ファイルで定義されています。詳細については、WMI Error Constants を参照してください。

ローカルの名前空間に接続する場合は、strUser、strPassword、strAuthority を指定しないでください。詳細については、Connecting to WMI on a Remote Computer を参照してください。

ConnectServer の使用方法の詳細については、Creating a Connection to a WMI Namespace を参照してください。なお、IWbemLocator への接続は、Cleaning up and Shutting Down a WMI Application で説明されているとおり、アプリケーションの終了時にシャットダウンする必要がある接続の 1 つです。

例

ConnectServer メソッドを使用する複数のサンプルについては、WMI C++ Application Examples を参照してください。

次の C++ のコード例は、指定した名前空間に接続する方法を示しています。

int _tmain(int argc, _TCHAR* argv[]) 
{ 
    // Initialize COM. ------------------------------------------ 
    HRESULT hres = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED); 
    if (FAILED(hres)) 
    { 
        wcout << "CoInitializeEx() failure:" << hex << (unsigned long)hres; 
        return 0; 
    } 
 
    // Obtain the initial locator to Windows Management 
    // on a particular host computer. 
    IWbemLocator *pLoc = NULL; 
    hres = CoCreateInstance(CLSID_WbemLocator, 0, CLSCTX_INPROC_SERVER,IID_IWbemLocator, (LPVOID *)&pLoc); 
    if (FAILED(hres)) 
    { 
        CoUninitialize(); 
        wcout << "CreateInstance failure:" << hex << (unsigned long)hres; 
        return 0; 
    } 
 
    // Connect to WMI through the IWbemLocator::ConnectServer method 
    // Connect to the local ROOT\CIMV2 namespace 
    // and obtain pointer pSvc to make IWbemServices calls. 
    IWbemServices *pSvc = NULL;
    BSTR namespace = SysAllocString(L"ROOT\\CimV2");
    hres = pLoc->ConnectServer(namespace, NULL, NULL, 0, NULL, 0, 0, &pSvc);
    SysFreeString(namespace);
 
    if (FAILED(hres)) 
    { 
        pLoc->Release(); 
        CoUninitialize(); 
        wcout << "ConnectServer() failure:" << hex << (unsigned long)hres; 
        return 0; 
    } 
    ...
}