IPortableDeviceValues::GetValue 方法
GetValue方法會擷取索引鍵所指定的PROPVARIANT值。
語法
HRESULT GetValue(
[in] REFPROPERTYKEY key,
[out] PROPVARIANT *pValue
);
參數
-
機碼 [in]
-
REFPROPERTYKEY 索引鍵,指定要擷取的專案。
-
pValue [out]
-
所擷取 之 PROPVARIANT 值的指標。 呼叫端必須在完成時呼叫 PropVariantClear 來釋放記憶體。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
索引 鍵 指定的屬性不在集合中。 |
備註
當 pValue 的 VARTYPE VT_VECTOR或VT_UI1時,不支援擷取 Null 或零大小的緩衝區。 例如,不允許 pValue.caub.pElems = Null 或 pValue.caub.cElems = 0。
這個方法可用來從集合中擷取任何類型的值。 不過,如果您事先知道實數值型別,請使用這個介面的其中一個特製化擷取方法,以避免直接使用 PROPVARIANT 值的額外負荷。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|