Get 函式
擷取指定的屬性值 (若它存在的話)。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT Get (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LPCWSTR wszName,
[in] LONG lFlags,
[out] VARIANT* pVal,
[out] CIMTYPE* pvtType,
[out] LONG* plFlavor
);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemClassObject 執行個體的指標。
wszName
[in] 屬性的名稱。
lFlags
[in] 保留。 這個參數必須是 0。
pVal
[out] 如果函式成功傳回，則包含 wszName 屬性的值。 pval 引數會獲派限定詞的正確型別和值。
pvtType
[out] 如果函式成功傳回，則包含代表屬性型別的 CIM 型別常數。 其值也可以是 null。
plFlavor
[out] 如果函式成功傳回，則會收到屬性來源的相關資訊。 其值可以是 null，或是 WbemCli.h 標頭檔中所定義的下列其中一個 WBEM_FLAVOR_TYPE 常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_FLAVOR_ORIGIN_SYSTEM |
0x40 | 屬性是標準系統屬性。 |
WBEM_FLAVOR_ORIGIN_PROPAGATED |
0x20 | 針對類別：屬性繼承自父類別。 針對執行個體：繼承自父類別的屬性尚未由執行個體修改。 |
WBEM_FLAVOR_ORIGIN_LOCAL |
0 | 針對類別：屬性屬於衍生類別。 針對執行個體：屬性由執行個體修改；也就是說，有提供值，或已新增或修改限定詞。 |
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | 發生一般失敗。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 一或多個參數無效。 |
WBEM_E_NOT_FOUND |
0x80041002 | 找不到指定的屬性。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 可用的記憶體不足，無法完成作業。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝向 IWbemClassObject::Get 方法發出的呼叫。
Get 函式也可以傳回系統屬性。
pVal 引數會獲派限定詞和 COM VariantInit 函式的正確型別和值
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起可用
