共用方式為

描述實例對象路徑

  • 發行項

實例物件路徑描述特定命名空間中指定類別實例的位置。

您可以有數種不同的實體物件路徑：

  • 滿

    完整實例物件路徑會將 類別之索引鍵屬性的名稱和值附加至完整的類別對象路徑。

    下列範例顯示完整實例對象路徑的定義。

    \\Server\Namespace:Class.KeyName="KeyValue"

  • 親戚

    相對物件路徑是指位於目前伺服器上目前命名空間中的實例。 相對路徑包含類別名稱，後面接著此實例索引鍵屬性的名稱和值。

    下列範例顯示相對實例物件路徑的定義。

    MyClass.MyProp="e:"

  • 單一鍵的相對參數

    對於只有一個指定為索引鍵之屬性的類別，您可以省略索引鍵屬性的名稱。

    下列範例顯示具有單一索引鍵之相對實例物件路徑的定義。

    MyClass="e:"

  • 具有多個鍵值的關係

    使用逗號來區分實例中的多個索引鍵。

    下列範例顯示多鍵相對實例物件路徑的定義。

    MyOtherClass.FirstKey=1,SecondKey=2

  • 單例類的相關性

    單一類別的相對物件路徑是由類別名稱所組成，後面接著 “=@” 表示法。

    下列範例顯示單一類別之相對實例物件路徑的定義。

    MySingletonClass=@

下列程式描述如何擷取類別實例。

擷取類別實例

  1. 使用呼叫 SysAllocString 函式，初始化包含物件路徑的字串。

  2. 初始化一個用來接收實例的物件。

  3. 使用呼叫 IWbemServices：：GetObject 或 IWbemServices：：GetObjectAsync來擷取 物件。

    若要使用 GetObjectAsync，您必須實作 IWbemSink介面。

本主題稍後所列的程序代碼需要下列 #include 語句，才能正確編譯。

#include <wbemidl.h>

下列程式代碼範例說明如何使用物件路徑擷取類別實例。

IWbemServices* pWbemSvcs = 0;

BSTR Path = SysAllocString(L"ComPort=2");    
IWbemClassObject *pComPort = 0;
pWbemSvcs->GetObject(Path, 0, 0, &pComPort, 0);

對於將多個屬性指定為索引鍵的類別實例，WMI 不需要在對象路徑中指定索引鍵屬性的特定順序。 您只需要指定物件路徑中每個屬性的值。

下列程式代碼範例描述兩個對等的索引鍵描述。

MyClass.IntVal=33,StrVal="AAA"
MyClass.StrVal="AAA",IntVal=33