表示 XML 中的物件
WMI 中的 XML 編碼器元件會產生 物件的 XML 表示。
在 C++ 中，您可以使用對 IWbemObjectTextSrc.GetText 方法的呼叫來啟動 XML 編碼器，並指定要以 XML 表示的物件，以及要用於表示的文字格式。 如需詳細資訊和程式碼範例，請參閱使用 C/C++ 在 XML 中編碼物件。
在 VBScript 或 Visual Basic 中，若要編碼 XML 實例的資料，請呼叫 SWbemObjectEx.GetText。 如需詳細資訊和程式碼範例，請參閱使用 VBScript 在 XML 中編碼物件。
本主題將討論下列各節：
使用 C 或 C++ 編碼物件
下列程式描述如何使用 C 或 C++ 在 XML 中編碼物件。
使用 C 或 C++ 在 XML 中編碼物件
設定程式以存取 WMI 資料。
由於 WMI 是以 COM 技術為基礎，您必須對 CoInitializeEx 和 CoInitializeSecurity 函式執行必要的呼叫，才能存取 WMI。 如需詳細資訊，請參閱 初始化 WMI 應用程式的 COM。
選擇性地建立 IWbemCoNtext 物件並加以初始化。
除非您需要變更預設作業，否則您不需要建立 IWbemCoNtext 物件。 XML 編碼器會使用內容物件來控制物件 XML 表示中包含的資訊量。
下表列出可針對內容物件指定的選擇性值。
實值/類型 意義 「LocalOnly」 VT_BOOL 若 為 TRUE，則只會在類別中本機定義的屬性和方法出現在產生的 XML 中。 預設值為 FALSE。 「IncludeQualifiers」 VT_BOOL 當 TRUE、類別、實例、屬性和方法限定詞包含在產生的 XML 中時。 預設值為 FALSE。 「ExcludeSystemProperties」 VT_BOOL 當 為 TRUE時，WMI 系統屬性會篩選掉輸出。 預設值為 FALSE。 「PathLevel」 VT_I4 - 0 = < 產生 CLASS > 或 < INSTANCE > 元素。
1 = 值 < 。產生 NAMEDOBJECT > 元素。
2 = 值 < 。產生 OBJECTWITHLOCALPATH > 元素。
3 = 值 < 。產生 OBJECTWITHPATH > 。
下列程式碼範例示範如何初始化內容物件，以包含限定詞和排除系統屬性。
VARIANT vValue; IWbemContext *pContext = NULL; HRESULT hr = CoCreateInstance (CLSID_WbemContext, NULL, CLSCTX_INPROC_SERVER, IID_IWbemContext, (void**) &pContext); if (FAILED(hr)) { printf("Create context failed with %x\n", hr); return hr; } // Generate a <VALUE.OBJECTWITHLOCALPATH> element VariantInit(&vValue); vValue.vt = VT_I4; vValue.lVal = 2; pContext->SetValue(L"PathLevel", 0, &vValue); VariantClear(&vValue); // Include qualifiers VariantInit(&vValue); vValue.vt = VT_BOOL; vValue.boolVal = VARIANT_TRUE; pContext->SetValue(L"IncludeQualifiers", 0, &vValue); VariantClear(&vValue); // Exclude system properties VariantInit(&vValue); vValue.vt = VT_BOOL; vValue.boolVal = VARIANT_TRUE; pContext->SetValue(L"ExcludeSystemProperties", 0, &vValue); VariantClear(&vValue);取得類別或實例的參考，以 XML 編碼。
初始化 COM 並聯機到 WMI 之後，請呼叫 GetObject 以擷取指定類別或實例的參考。 如果您使用 BSTR 來指定類別或實例，請呼叫 SysFreeString 以釋放 SysAllocString配置的記憶體。
下列程式碼範例會擷取 Win32_LogicalDisk 實例的參考。
HRESULT hr = NULL; IWbemClassObject *pClass = NULL; BSTR strObj = SysAllocString(L"Win32_LogicalDisk"); hr = pConnection->GetObject(strObj, 0, NULL, &pClass, NULL); SysFreeString(strObj); if (FAILED(hr)) { printf("GetObject failed with %x\n",hr) return hr; }建立 IWbemObjectTextSrc 物件。
取得物件的參考之後，您必須使用對CoCreateInstance的呼叫來建立IWbemObjectTextSrc物件。 IWbemObjectTextSrc物件是用來產生實際的 XML 文字。
下列程式碼範例示範如何藉由呼叫CoCreateInstance來建立IWbemObjectTextSrc物件。
HRESULT hr = NULL; IWbemObjectTextSrc *pSrc = NULL; hr = CoCreateInstance (CLSID_WbemObjectTextSrc, NULL, CLSCTX_INPROC_SERVER, IID_IWbemObjectTextSrc, (void**) &pSrc); if (FAILED(hr)) { printf("CoCreateInstance of IWbemObjectTextSrc failed %x\n",hr); return hr; }叫用 IWbemObjectTextSrc.GetText 方法，以取得物件的 XML 表示。
設定物件標記法的內容之後，取得物件的參考，並建立IWbemObjectTextSrc 物件之後，您就可以呼叫 IWbemObjectTextSrc.GetText方法來產生指定物件的 XML 表示法。
下列 C++ 範例程式碼會產生 pClass所參考物件的 XML 標記法。 XML 標記法會在 strText中傳回。 GetText的第三個參數會指定要用於 XML 的文字格式，而且必須是WMI_OBJ_TEXT_CIM_DTD_2_0 (0x1) 或WMI_OBJ_TEXT_WMI_DTD_2_0 (0x2) 。 如需這些值的詳細資訊，請參閱 IWbemObjectTextSrc：：GetText 參數值。
HRESULT hr = NULL; BSTR strText = NULL; hr = pSrc->GetText(0, pClass, WMI_OBJ_TEXT_CIM_DTD_2_0, pContext, &strText); // Perform a task with strText SysFreeString(strText); if (FAILED(hr)) { printf("GetText failed with %x\n", hr); return hr; }
下列 C++ 範例程式碼包含上一個程式中的所有步驟，並在 XML 中編碼 Win32_LogicalDisk 類別，包括類別、屬性和方法限定詞，以及排除系統屬性。
// The following #define statement is needed so that
// the proper values are loaded by the #include files.
#define _WIN32_WINNT 0x0500
#include <stdio.h>
#include <wbemcli.h>
#pragma comment(lib, "wbemuuid.lib")
// Initialize the context object
// ---------------------------------------------
void FillUpContext(IWbemContext *pContext)
{
VARIANT vValue;
// IncludeQualifiers
VariantInit(&vValue);
vValue.vt = VT_BOOL;
vValue.boolVal = VARIANT_FALSE;
pContext->SetValue(L"IncludeQualifiers", 0, &vValue);
VariantClear(&vValue);
VariantInit(&vValue);
vValue.vt = VT_I4;
vValue.lVal = 0;
pContext->SetValue(L"PathLevel", 0, &vValue);
VariantClear(&vValue);
// ExcludeSystemProperties
VariantInit(&vValue);
vValue.vt = VT_BOOL;
vValue.boolVal = VARIANT_TRUE;
pContext->SetValue(L"ExcludeSystemProperties", 0, &vValue);
VariantClear(&vValue);
}
// Main method ... drives the program
// ---------------------------------------------
int _cdecl main(int argc, char * argv[])
{
BSTR strNs = NULL;
BSTR strObj = NULL;
BSTR strText = NULL;
if(FAILED(CoInitialize(NULL)))
return 1;
HRESULT hr = E_FAIL;
IWbemObjectTextSrc *pSrc = NULL;
IWbemLocator *pL = NULL;
if(SUCCEEDED(hr = CoCreateInstance (CLSID_WbemLocator,
NULL,
CLSCTX_INPROC_SERVER,
IID_IWbemLocator,
(void**) &pL)))
{
// Create a context object
IWbemContext *pContext = NULL;
if(SUCCEEDED(hr = CoCreateInstance (CLSID_WbemContext,
NULL,
CLSCTX_INPROC_SERVER,
IID_IWbemContext,
(void**) &pContext)))
{
FillUpContext(pContext);
IWbemServices *pConnection = NULL;
strNs = SysAllocString(L"root\\cimv2");
strText = NULL;
if(SUCCEEDED(hr = pL->ConnectServer(strNs,
NULL,
NULL,
NULL,
0,
NULL,
NULL,
&pConnection)))
{
IWbemClassObject *pClass = NULL;
strObj = SysAllocString(L"Win32_LogicalDisk");
if(SUCCEEDED(hr = CoCreateInstance (CLSID_WbemObjectTextSrc,
NULL,
CLSCTX_INPROC_SERVER,
IID_IWbemObjectTextSrc,
(void**) &pSrc)))
{
// Test for GetObject
if(SUCCEEDED(hr = pConnection->GetObject(strObj,
0,
NULL,
&pClass,
NULL)))
{
if(SUCCEEDED(hr = pSrc->GetText(0,
pClass,
WMI_OBJ_TEXT_CIM_DTD_2_0,
pContext,
&strText)))
{
printf("GETOBJECT SUCCEEDED\n");
printf("==========================================\n");
wprintf(strText);
pContext->Release();
pClass->Release();
}
else
{
printf("GetText failed with %x\n", hr);
// Free up the object
pContext->Release();
pClass->Release();
}
}
else
printf("GetObject failed with %x\n", hr);
}
else
printf("CoCreateInstance on WbemObjectTextSrc failed with %x\n", hr);
}
else
printf("ConnectServer on root\\cimv2 failed with %x\n", hr);
}
else
printf("CoCreateInstance on Context failed with %x\n", hr);
}
else
printf("CoCreateInstance on Locator failed with %x\n", hr);
// Clean up memory
if (strNs != NULL)
SysFreeString(strNs);
if (strObj != NULL)
SysFreeString(strObj);
if (strText != NULL)
SysFreeString(strText);
if (pSrc != NULL)
pSrc->Release();
if (pL != NULL)
pL->Release();
return 0;
}
使用 VBScript 編碼物件
下列程式描述如何使用 VBScript 在 XML 中編碼物件。
使用 VBScript 在 XML 中編碼物件
您可以選擇性地建立 SWbemNamedValueSet 物件， 並將其初始化，以便設定 XML 表示所需的內容值。
下列程式碼範例示範值如何指示 XML 編碼器產生 < VALUE。OBJECTWITHLOCALPATH > 元素，包括所有限定詞，並在建構物件的 XML 表示時排除系統屬性。
' Create an optional SWbemNamedValueSet object set context = CreateObject("wbemscripting.SWbemNamedValueSet") ' Initialize the value set object to set the context ' Generate a <VALUE.OBJECTWITHLOCALPATH> element context.add "PathLevel", 2 context.add "IncludeQualifiers", true context.add "ExcludeSystemProperties", true '擷取物件或類別的實例，以 XML 表示。
下列程式碼範例會擷取 物件的實例。
' Retrieve the object/class to be represented in XML set myObj = GetObject("winmgmts:\\.\root\cimv2:win32_LogicalDisk")使用 1 做為 參數來指定對應至 CIM DTD 2.0 版或 2 的文字格式，以指定對應至 WMI DTD 2.0 版的文字格式，叫用在上一個步驟中建立之實例 的 GetText_ 方法。 如果您在步驟 1 中建立 SWbemNamedValueSet 物件，請將它包含在參數清單中做為第三個參數。
下列程式碼範例示範如何叫用 實例的 GetText_ 方法。
' Get the XML representation of the object strText = myObj.GetText_(2,,context) ' If you have not used a SWbemNamedValueSet object ' enter the following line. strText = myObj.GetText_(2)或者，藉由建立 XML 檔物件模型， (DOM) 物件，然後將 XML 文字載入其中，以選擇性地驗證步驟 3 中產生的 XML 格式正確。
下列程式碼範例示範如何建立和初始化 XML DOM 物件，並將 XML 文字載入其中。
' Create an XMLDOM object set xml = CreateObject("Microsoft.xmldom") ' Initialize the XMLDOM object so results are returned synchronously xml.async = false ' Load the XML into the XMLDOM object xml.loadxml strText輸出 物件的 XML 表示。
下列程式碼範例示範如何使用 wscript 來輸出 XML。
wscript.echo strText如果您選擇使用 XML DOM 來確認產生的 XML 格式正確，請將上一行取代為下列專案。
wscript.echo xml.xml
下列 VBScript 程式碼範例包含上述程式中的所有步驟，並以 XML 編碼 Win32_LogicalDisk 類別，包括類別、屬性和方法限定詞，以及排除系統屬性。
' Create optional SWbemNamedValueSet object
set context = CreateObject("Wbemscripting.SWbemNamedValueSet")
' Initialize the context object
context.add "PathLevel", 2
context.add "IncludeQualifiers", true
context.add "ExcludeSystemProperties", true
' Retrieve the object/class to be represented in XML
set myObj = GetObject("winmgmts:\\.\root\cimv2:Win32_LogicalDisk")
' Get the XML representation of the object
strText = myObj.GetText_(2,,context)
' If you have not used a SWbemNamedValueSet object
' use the following line
' strText = myObj.GetText(2)
' Print the XML representation
wscript.echo strText
' If you choose to use the XML DOM to verify
' that the XML generated is well-formed, replace the last
' line in the above code example with the following lines:
' Create an XMLDOM object
set xml = CreateObject("Microsoft.xmldom")
' Initialize the XMLDOM object so results are
' returned synchronously
xml.async = false
' Load the XML into the XMLDOM object
xml.loadxml strText
' Print the XML representation
wscript.echo xml.xml
相關主題
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應