GetPropertyHandle 函式
傳回識別屬性的唯一控制代碼。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT GetPropertyHandle (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] LPCWSTR wszPropertyName,
[out] CIMTYPE* pType,
[out] long* pHandle
);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemObjectAccess 執行個體的指標。
wszPropertyName
[in] 包含屬性名稱且以 UTF16 字元編碼的 Null 終止字串。
pType
[out] CIMTYPE 列舉成員的指標，表示屬性的 CIM 型別。
pHandle
[out] 指標，指向包含屬性控制代碼的整數。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_NOT_FOUND |
0x80041002 | 找不到指定的屬性名稱。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 參數無效。 |
WBEM_E_NOT_SUPPORTED |
0x8004100c | 要求的屬性的型別為 CIM_OBJECT 或 CIM_ARRAY。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝向 IWbemClassObject::GetPropertyHandle 方法發出的呼叫。
使用 IWbemObjectAccess 方法來讀取或寫入屬性值時，您可以使用這個控制代碼來識別屬性。
您可以針對 CIM_OBJECT 和 CIM_ARRAY 以外的所有資料型別屬性擷取控制代碼。 傳回的控制代碼可在類別的所有執行個體上運作。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起可用
