IPropertyStore::GetValue 方法 (propsys.h)
這個方法會擷取特定屬性的數據。
語法
HRESULT GetValue(
REFPROPERTYKEY key,
PROPVARIANT *pv
);
參數
key
TBD
pv
IPropertyStore::GetValue
方法傳回成功之後,此參數會指向包含屬性相關數據的 PROPVARIANT 結構。
傳回值
如果成功,則傳回S_OK或INPLACE_S_TRUNCATED,否則傳回錯誤值。
傳回INPLACE_S_TRUNCATED,表示傳回的 PROPVARIANT 已轉換成更正式的格式。 例如,這會從字串值修剪開頭或尾端空格。 您必須使用 SUCCEEDED 宏來檢查傳回值,這個值會將INPLACE_S_TRUNCATED視為成功的程式代碼。 SUCCEEDED 宏定義於 Winerror.h 檔案中。
備註
如果索引鍵中所參考的 PROPERTYKEY 不存在於屬性存放區中,這個方法會傳回S_OK,而且 pv 所指向結構的 vt 成員會設定為 VT_EMPTY。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista 和更新版本的 Windows 作業系統。 |
目標平台 | Universal |
標頭 | propsys.h |
程式庫 | Propsys.idl |
IRQL | 所有層級 |