IPortableDeviceValues::GetValue 方法
GetValue 方法检索由键指定的 PROPVARIANT 值。
语法
HRESULT GetValue(
[in] REFPROPERTYKEY key,
[out] PROPVARIANT *pValue
);
参数
-
key [in]
-
指定要检索的项的 REFPROPERTYKEY 键。
-
pValue [out]
-
指向检索到的 PROPVARIANT 值的指针。 调用方在使用完内存后,必须通过调用 PropVariantClear 来释放内存。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
由 key 指定的属性不在集合中。 |
备注
当 pValue 的 VARTYPE VT_VECTOR或VT_UI1时,不支持检索 NULL 或零大小的缓冲区。 例如,不允许 pValue.caub.pElems = NULL 或 pValue.caub.cElems = 0。
此方法可用于从集合中检索任何类型的值。 但是,如果事先知道值类型,请使用此接口的一种专用检索方法,以避免直接使用 PROPVARIANT 值的开销。
要求
要求 | Value |
---|---|
标头 |
|
库 |
|