IWbemServices 接口 (wbemcli.h)

项目
08/27/2023

客户端和提供程序使用 IWbemServices 接口访问 WMI 服务。接口由 WMI 和 WMI 提供程序实现，是主 WMI 接口。

    IWbemClassObject *pObj = NULL;

    // The pWbemSvc pointer is of type IWbemServices*
    // BSTR is not compatible with wchar_t, need to allocate.
    BSTR path = SysAllocString(L"path");
    pWbemSvc->GetObject(path, 0, 0, &pObj, 0);
    SysFreeString(path);

继承

IWbemServices 接口继承自 IUnknown 接口。 IWbemServices 还具有以下类型的成员：

方法

IWbemServices 接口具有这些方法。


IWbemServices：：CancelAsyncCall IWbemServices：：CancelAsyncCall 方法根据最初传递给异步方法的 IWbemObjectSink 指针取消任何当前挂起的异步调用。
IWbemServices::CreateClassEnum IWbemServices：：CreateClassEnum 方法返回满足选择条件的所有类的枚举器。
IWbemServices::CreateClassEnumAsync IWbemServices：：CreateClassEnumAsync 方法返回类提供程序支持的所有类的枚举。
IWbemServices::CreateInstanceEnum IWbemServices：：CreateInstanceEnum 方法创建一个枚举器，该枚举器根据用户指定的选择条件返回指定类的实例。
IWbemServices::CreateInstanceEnumAsync IWbemServices：：CreateInstanceEnumAsync 方法创建一个枚举器，该枚举器根据用户指定的选择条件异步返回指定类的实例。
IWbemServices：:D eleteClass IWbemServices：:D eleteClass 方法从当前命名空间中删除指定的类。
IWbemServices：:D eleteClassAsync IWbemServices：:D eleteClassAsync 方法从当前命名空间中删除指定的类。
IWbemServices::DeleteInstance IWbemServices：:D eleteInstance 方法删除当前命名空间中现有类的实例。
IWbemServices：:D eleteInstanceAsync IWbemServices：:D eleteInstanceAsync 方法异步删除当前命名空间中现有类的实例。操作的确认或失败通过调用方实现的 IWbemObjectSink 接口报告。
IWbemServices::ExecMethod 执行 CIM 对象导出的方法。
IWbemServices::ExecMethodAsync 异步执行 CIM 对象导出的方法。
IWbemServices::ExecNotificationQuery IWbemServices：：ExecNotificationQuery 方法执行查询以接收事件。调用会立即返回，用户可以轮询返回的枚举器，以便在事件到达时轮询这些事件。释放返回的枚举器将取消查询。
IWbemServices::ExecNotificationQueryAsync IWbemServices：：ExecNotificationQueryAsync 方法执行与 IWbemServices：：ExecNotificationQuery 相同的任务，只不过事件将提供给指定的响应处理程序，直到调用 CancelAsyncCall 以停止事件通知。
IWbemServices::ExecQuery IWbemServices：：ExecQuery 方法执行查询以检索对象。
IWbemServices::ExecQueryAsync IWbemServices：：ExecQueryAsync 方法执行查询以异步方式检索对象。
IWbemServices::GetObject IWbemServices：：GetObject 方法检索类或实例。此方法仅从与当前 IWbemServices 对象关联的命名空间检索对象。
IWbemServices::GetObjectAsync IWbemServices：：GetObjectAsync 方法根据其路径检索对象（类定义或实例）。
IWbemServices::OpenNamespace IWbemServices：：OpenNamespace 方法为调用方提供了一个新的 IWbemServices 指针，该指针具有指定的子命名空间作为其操作上下文。
IWbemServices::PutClass IWbemServices：:P utClass 方法创建新类或更新现有类。 pObject 参数指定的类必须已使用所有必需的属性值正确初始化。
IWbemServices::PutClassAsync IWbemServices：:P utClassAsync 方法创建新类或更新现有类。
IWbemServices::PutInstance IWbemServices：:P utInstance 方法创建或更新现有类的实例。将该实例写入 WMI 存储库。
IWbemServices::PutInstanceAsync IWbemServices：:P utInstanceAsync 方法异步创建或更新现有类的实例。更新确认或错误报告通过调用方实现的 IWbemObjectSink 接口提供。
IWbemServices：：QueryObjectSink IWbemServices：：QueryObjectSink 方法允许调用方获取由 Windows 管理导出的通知处理程序。

注解

实现 IWbemServices 接口的 提供程序必须遵循其实现的每个方法的文档语义;和提供程序必须支持指定的错误返回代码。 WMI 实现所有方法，通常每个提供程序在接口上实现一小部分可用功能。提供程序必须为它们未实现的任何方法返回WBEM_E_PROVIDER_NOT_CAPABLE。

在调用接口方法之前，任何 IWbemServices 方法中的所有出站接口指针都应初始化为 NULL 。例如，调用 IWbemServices：：GetObject 方法会返回一个 IWbemClassObject 接口指针，该指针应在调用 IWbemServices：：GetObject 方法之前预先初始化为 NULL。

示例

有关使用 IWbemServices 的多个 C++ 示例，请参阅 WMI C++ 应用程序示例部分。

下面的代码示例演示提供程序如何获取 IWbemServices 指针。代码需要以下 #include 语句和引用才能编译。

#include <iostream>
using namespace std;
#include <wbemidl.h>
#pragma comment(lib, "wbemuuid.lib")

IWbemLocator *pIWbemLocator = NULL;

HRESULT hRes = CoCreateInstance (
            CLSID_WbemAdministrativeLocator,
            NULL ,
            CLSCTX_INPROC_SERVER | CLSCTX_LOCAL_SERVER , 
            IID_IUnknown ,
            ( void ** ) &pIWbemLocator
            ) ;

IWbemServices *pWbemServices = NULL;

if (SUCCEEDED(hRes))
{
    BSTR namespace = SysAllocString(L"root\\CIMV2");
    hRes = pIWbemLocator->ConnectServer(
                namespace,      // Namespace
                NULL,           // Userid
                NULL,           // PW
                NULL,           // Locale
                0,              // flags
                NULL,           // Authority
                NULL,           // Context
                &pWbemServices
                );
    SysFreeString(namespace);            

    pIWbemLocator->Release(); // Free memory resources.

    // Use pWbemServices

}

// Clean up
pWbemServices->Release();

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	wbemcli.h (包括 Wbemidl.h)

另请参阅

IWbemServices 接口 (wbemcli.h)

继承

方法

注解

示例

要求

另请参阅

反馈

反馈

其他资源