Пример. Получение данных WMI с локального компьютера
Процедуру и примеры кода в этом разделе можно использовать для создания полного клиентского приложения WMI, которое выполняет инициализацию COM, подключается к WMI на локальном компьютере, полусинхронно извлекает данные, а затем выполняет очистку. Этот пример получает имя операционной системы на локальном компьютере и отображает его. Сведения о получении данных с удаленного компьютера см. в разделе Пример. Получение данных WMI с удаленного компьютера. Сведения об асинхронном получении данных см. в разделе Пример. Асинхронное получение данных WMI с локального компьютера.
Следующая процедура используется для выполнения приложения WMI. Шаги 1–5 содержат все шаги, необходимые для настройки И подключения к WMI, а шаги 6 и 7 — запросы и получение данных.
Инициализация параметров COM с помощью вызова CoInitializeEx.
Дополнительные сведения см. в разделе Инициализация COM для приложения WMI.
Инициализируйте безопасность процессов COM, вызвав CoInitializeSecurity.
Дополнительные сведения см. в разделе Настройка уровня безопасности процесса по умолчанию с помощью C++.
Получите начальный указатель для WMI, вызвав CoCreateInstance.
Дополнительные сведения см. в разделе Создание подключения к пространству имен WMI.
Получите указатель на IWbemServices для пространства имен root\cimv2 на локальном компьютере, вызвав IWbemLocator::ConnectServer. Сведения о подключении к удаленному компьютеру см. в разделе Пример. Получение данных WMI с удаленного компьютера.
Дополнительные сведения см. в разделе Создание подключения к пространству имен WMI.
Настройте безопасность прокси-сервера IWbemServices , чтобы служба WMI могла олицетворять клиента, вызвав CoSetProxyBlanket.
Дополнительные сведения см. в разделе Настройка уровней безопасности для WMI-подключения.
Используйте указатель IWbemServices для выполнения запросов WMI. В этом примере выполняется запрос имени операционной системы путем вызова IWbemServices::ExecQuery.
Следующий WQL-запрос является одним из аргументов метода.
SELECT * FROM Win32_OperatingSystemРезультат этого запроса хранится в указателе IEnumWbemClassObject . Это позволяет получать объекты данных из запроса полусинхронно с помощью интерфейса IEnumWbemClassObject . Дополнительные сведения см. в разделе Перечисление WMI. Сведения об асинхронном получении данных см. в разделе Пример. Асинхронное получение данных WMI с локального компьютера.
Дополнительные сведения о выполнении запросов к WMI см. в разделах Управление сведениями о классе и экземпляре, Запрос WMI и Вызов метода.
Получение и отображение данных из WQL-запроса. Указатель IEnumWbemClassObject связан с объектами данных, возвращенными запросом, и объекты данных можно получить с помощью метода IEnumWbemClassObject::Next . Этот метод связывает объекты данных с указателем IWbemClassObject , который передается в метод . Используйте метод IWbemClassObject::Get , чтобы получить нужную информацию из объектов данных.
Следующий пример кода используется для получения свойства Name из объекта данных, который предоставляет имя операционной системы.
VARIANT vtProp; VariantInit(&vtProp); // Get the value of the Name property hr = pclsObj->Get(L"Name", 0, &vtProp, 0, 0);После того как значение свойства Name хранится в переменной VARIANT vtProp, оно может быть отображено пользователю.
Дополнительные сведения см. в разделе Перечисление WMI.
В следующем примере кода данные 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;
// Step 1: --------------------------------------------------
// Initialize COM. ------------------------------------------
hres = CoInitializeEx(0, COINIT_MULTITHREADED);
if (FAILED(hres))
{
cout << "Failed to initialize COM library. Error code = 0x"
<< hex << hres << endl;
return 1; // Program has failed.
}
// Step 2: --------------------------------------------------
// Set general COM security levels --------------------------
hres = CoInitializeSecurity(
NULL,
-1, // COM authentication
NULL, // Authentication services
NULL, // Reserved
RPC_C_AUTHN_LEVEL_DEFAULT, // Default authentication
RPC_C_IMP_LEVEL_IMPERSONATE, // Default 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.
}
// Step 3: ---------------------------------------------------
// Obtain the initial locator to WMI -------------------------
IWbemLocator *pLoc = NULL;
hres = CoCreateInstance(
CLSID_WbemLocator,
0,
CLSCTX_INPROC_SERVER,
IID_IWbemLocator, (LPVOID *) &pLoc);
if (FAILED(hres))
{
cout << "Failed to create IWbemLocator object."
<< " Err code = 0x"
<< hex << hres << endl;
CoUninitialize();
return 1; // Program has failed.
}
// Step 4: -----------------------------------------------------
// Connect to WMI through the IWbemLocator::ConnectServer method
IWbemServices *pSvc = NULL;
// 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"), // Object path of WMI namespace
NULL, // User name. NULL = current user
NULL, // User password. NULL = current
0, // Locale. NULL indicates current
NULL, // Security flags.
0, // Authority (for example, Kerberos)
0, // Context object
&pSvc // pointer to 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;
// Step 5: --------------------------------------------------
// Set security levels on the proxy -------------------------
hres = CoSetProxyBlanket(
pSvc, // Indicates the proxy to set
RPC_C_AUTHN_WINNT, // RPC_C_AUTHN_xxx
RPC_C_AUTHZ_NONE, // RPC_C_AUTHZ_xxx
NULL, // Server principal name
RPC_C_AUTHN_LEVEL_CALL, // RPC_C_AUTHN_LEVEL_xxx
RPC_C_IMP_LEVEL_IMPERSONATE, // RPC_C_IMP_LEVEL_xxx
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.
}
// Step 6: --------------------------------------------------
// Use the IWbemServices pointer to make requests of WMI ----
// For example, get the name of the operating system
IEnumWbemClassObject* pEnumerator = NULL;
hres = pSvc->ExecQuery(
bstr_t("WQL"),
bstr_t("SELECT * FROM Win32_OperatingSystem"),
WBEM_FLAG_FORWARD_ONLY | WBEM_FLAG_RETURN_IMMEDIATELY,
NULL,
&pEnumerator);
if (FAILED(hres))
{
cout << "Query for operating system name failed."
<< " Error code = 0x"
<< hex << hres << endl;
pSvc->Release();
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
// Step 7: -------------------------------------------------
// Get the data from the query in step 6 -------------------
IWbemClassObject *pclsObj = NULL;
ULONG uReturn = 0;
while (pEnumerator)
{
HRESULT hr = pEnumerator->Next(WBEM_INFINITE, 1,
&pclsObj, &uReturn);
if(0 == uReturn)
{
break;
}
VARIANT vtProp;
VariantInit(&vtProp);
// Get the value of the Name property
hr = pclsObj->Get(L"Name", 0, &vtProp, 0, 0);
wcout << " OS Name : " << vtProp.bstrVal << endl;
VariantClear(&vtProp);
pclsObj->Release();
}
// Cleanup
// ========
pSvc->Release();
pLoc->Release();
pEnumerator->Release();
CoUninitialize();
return 0; // Program successfully completed.
}