IPropertyStore：：SetValue 方法 (propsys.h)

這個方法會設定屬性值，或取代或移除現有的值。

語法

HRESULT SetValue(
  REFPROPERTYKEY key,
  REFPROPVARIANT propvar
);

key

TBD

propvar

TBD

方法 IPropertyStore::SetValue 可以傳回下列任一項：

IPropertyStore::SetValue 只會影響目前的屬性存放區實例。屬性處理程式會 IPropertyStore::SetValue 藉由累積記憶體內部數據結構中的屬性變更來實作。只有在呼叫 IPropertyStore：：Commit 時，屬性變更才會寫入數據流。

如果在只讀屬性存放區上呼叫 IPropertyStore：：Commit ，則屬性處理程式會決定此專案，並傳回STG_E_ACCESSDENIED。

如果值已新增或移除，SetValue則 IPropertyStore：：GetCount 和 IPropertyStore：：GetAt 的後續列舉會反映該變更和後續呼叫以IPropertyStore::SetValue反映變更的值。

新增屬性

如果索引鍵所指向的屬性值不存在於存放區中， IPropertyStore::SetValue 請將值新增至存放區。

取代現有的屬性值

如果索引鍵所指向的屬性值已存在於存放區中，則會取代預存的值。

拿掉現有屬性

若要從屬性存放區中移除值，請將 pv 指向之結構的 vt 成員設定為VT_EMPTY。如果該值不存在，則不執行任何動作，而且方法會傳回S_OK。

需求	值
最低支援的用戶端	適用於 Windows Vista 和更新版本的 Windows 作業系統。
目標平台	Universal
標頭	propsys.h
程式庫	Propsys.idl
IRQL	所有層級