描述實例物件路徑

  • 發行項

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

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

  • 完整

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

    下列範例顯示完整實例物件路徑的定義。

    \\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