您可以使用本主题中的过程和代码示例创建一个完整的 WMI客户端应用程序,该应用程序执行 COM 初始化、连接到本地计算机上的 WMI、读取一些数据并清理。连接到远程计算机上的 WMI描述了如何从远程计算机获取数据。
下面的过程包括所有C++ WMI应用程序所需的所有步骤。
1.通过调用 ColinitializeEx来初始化COM参数。
有关详细信息,请参阅为WMI应用程序初始化COM。
2.通过调用 ColinitializeSecurity来初始化COM进程的安全性。
有关详细信息,请参见使用C++设置默认进程安全级别。
3.通过调用 WbemLocator::ConnectServer,获取指定主机(简单情况下是本地计算机)上命名空间的IWBEM Services指针。
要连接到远程计算机(例如Computer_A),请使用以下对象路径参数:
_bstr_t(L"\\COMPUTER_A\ROOT\\CIMV2")
4.设置lWBEM Services代理安全性,以便WMI服务可以通过调用CoSetProxyBlanket来冒充客户端。
5.使用lWBEM Services指针对WMI发出请求。例如,查询所有Win32 Service实例以确定停止了哪些服务。。
6.清理对象和COM。
下面的示例代码是一个完整的WMI客户端应用程序
#define _WIN32_DCOM
#include <iostream>
using namespace std;
#include <comdef.h>
#include <Wbemidl.h>
#pragma comment(lib, "wbemuuid.lib")
int main(int argc, char **argv)
{
HRESULT hres;
// Initialize COM.
//hres = CoInitializeEx(0, COINIT_MULTITHREADED);
hres = CoInitialize(NULL);
if (FAILED(hres))
{
cout << "Failed to initialize COM library. "
<< "Error code = 0x"
<< hex << hres << endl;
return 1; // Program has failed.
}
// Initialize
hres = CoInitializeSecurity(
NULL,
-1, // COM negotiates service
NULL, // Authentication services
NULL, // Reserved
RPC_C_AUTHN_LEVEL_DEFAULT, // authentication
RPC_C_IMP_LEVEL_IMPERSONATE, // Impersonation
NULL, // Authentication info
EOAC_NONE, // Additional capabilities
NULL // Reserved
);
if (FAILED(hres))
{
cout << "Failed to initialize security. "
<< "Error code = 0x"
<< hex << hres << endl;
CoUninitialize();
return 1; // Program has failed.
}
// Obtain the initial locator to Windows Management
// on a particular host computer.
IWbemLocator *pLoc = 0;
hres = CoCreateInstance(
CLSID_WbemLocator,
0,
CLSCTX_INPROC_SERVER,
IID_IWbemLocator, (LPVOID *) &pLoc);
if (FAILED(hres))
{
cout << "Failed to create IWbemLocator object. "
<< "Error code = 0x"
<< hex << hres << endl;
CoUninitialize();
return 1; // Program has failed.
}
IWbemServices *pSvc = 0;
// Connect to the root\cimv2 namespace with the
// current user and obtain pointer pSvc
// to make IWbemServices calls.
hres = pLoc->ConnectServer(
_bstr_t(L"ROOT\\CIMV2"), // WMI namespace
NULL, // User name
NULL, // User password
0, // Locale
NULL, // Security flags
0, // Authority
0, // Context object
&pSvc // IWbemServices proxy
);
if (FAILED(hres))
{
cout << "Could not connect. Error code = 0x"
<< hex << hres << endl;
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
cout << "Connected to ROOT\\CIMV2 WMI namespace" << endl;
// Set the IWbemServices proxy so that impersonation
// of the user (client) occurs.
hres = CoSetProxyBlanket(
pSvc, // the proxy to set
RPC_C_AUTHN_WINNT, // authentication service
RPC_C_AUTHZ_NONE, // authorization service
NULL, // Server principal name
RPC_C_AUTHN_LEVEL_CALL, // authentication level
RPC_C_IMP_LEVEL_IMPERSONATE, // impersonation level
NULL, // client identity
EOAC_NONE // proxy capabilities
);
if (FAILED(hres))
{
cout << "Could not set proxy blanket. Error code = 0x"
<< hex << hres << endl;
pSvc->Release();
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
// Use the IWbemServices pointer to make requests of WMI.
// Make requests here:
// For example, query for all the running processes
IEnumWbemClassObject* pEnumerator = NULL;
hres = pSvc->ExecQuery(
bstr_t("WQL"),
bstr_t("SELECT * FROM Win32_Process"),
WBEM_FLAG_FORWARD_ONLY | WBEM_FLAG_RETURN_IMMEDIATELY,
NULL,
&pEnumerator);
if (FAILED(hres))
{
cout << "Query for processes failed. "
<< "Error code = 0x"
<< hex << hres << endl;
pSvc->Release();
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
else
{
IWbemClassObject *pclsObj;
ULONG uReturn = 0;
while (pEnumerator)
{
hres = pEnumerator->Next(WBEM_INFINITE, 1,
&pclsObj, &uReturn);
if(0 == uReturn)
{
break;
}
VARIANT vtProp;
// Get the value of the Name property
hres = pclsObj->Get(L"Name", 0, &vtProp, 0, 0);
wcout << "Process Name : " << vtProp.bstrVal << endl;
VariantClear(&vtProp);
pclsObj->Release();
pclsObj = NULL;
}
}
// Cleanup
// ========
pSvc->Release();
pLoc->Release();
pEnumerator->Release();
CoUninitialize();
return 0; // Program successfully completed.
}
备注:
CoInitialize 和 CoInitializeEx
1.CoInitialize:
定义: CoInitialize 是一个简单的函数,用于初始化 COM 库,使当前线程能够使用 COM 功能。
参数:
CoInitialize 不接受参数,默认为 COINIT_MULTITHREADED。
线程模型: 这意味着该线程会成为线程安全的线程,适合于多线程环境。
使用场景: 在大多数情况下,简单地调用 CoInitialize 就足够了,特别是在你的线
程将要调用 COM 对象但不需要高级线程模型选择的情况下。
2.CoInitializeEx:
定义: CoInitializeEx 是一个更灵活的函数,使你可以指定初始化选项。
参数:
pvReserved: 保留参数,通常设置为 NULL。
dwCoInit: 定义线程的并发性,主要有两个选项:
COINIT_APARTMENTTHREADED: 线程将使用单一线程模型 (STA)。
COINIT_MULTITHREADED: 线程将使用多线程模型 (MTA)。
线程模型: 选择不同的 dwCoInit 选项,允许你在单线程和多线程环境中优化 COM 的使用。
使用场景: 如果你的应用程序需要指定线程模型,例如在 UI 应用程序中你可能会需要 STA,而在提供多线程服务时可能会使用 MTA。