IPortableDeviceValues::GetValue 方法

GetValue方法會擷取索引鍵所指定的PROPVARIANT值。

語法

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

參數

機碼 [in]

REFPROPERTYKEY 索引鍵,指定要擷取的專案。

pValue [out]

所擷取 之 PROPVARIANT 值的指標。 呼叫端必須在完成時呼叫 PropVariantClear 來釋放記憶體。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
索引 指定的屬性不在集合中。

備註

pValue 的 VARTYPE VT_VECTOR或VT_UI1時,不支援擷取 Null 或零大小的緩衝區。 例如,不允許 pValue.caub.pElems = Null 或 pValue.caub.cElems = 0。

這個方法可用來從集合中擷取任何類型的值。 不過,如果您事先知道實數值型別,請使用這個介面的其中一個特製化擷取方法,以避免直接使用 PROPVARIANT 值的額外負荷。

規格需求

需求
標頭
PortableDeviceTypes.h
程式庫
PortableDeviceGUIDs.lib

另請參閱

IPortableDeviceValues 介面

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue