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 所有層級

另請參閱

IPropertyStore

IPropertyStore：：GetAt