PSPropertyBag_WritePropertyKey函式 (propsys.h)

設定屬性包中屬性的屬性索引鍵值。

語法

PSSTDAPI PSPropertyBag_WritePropertyKey(
  [in] IPropertyBag   *propBag,
  [in] LPCWSTR        propName,
  [in] REFPROPERTYKEY value
);

[in] propBag

IPropertyBag 物件的指標，代表儲存屬性的屬性包。

[in] propName

類型： LPCWSTR

以 Null 結尾的屬性名稱字串。

[in] value

類型： REFPROPERTYKEY

PROPERTYKEY 結構，指定要儲存在屬性中的屬性索引鍵值。

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

屬性索引鍵可唯一識別屬性。例如，PKEY_Keywords 會對應到 System.Keywords。此函式只會針對註冊為屬性架構一部分的屬性成功。

屬性包屬性函式 API 會在視窗類型與用來表示屬性包中值的 VARIANT 類型之間轉換。這麼做可簡化屬性包的使用方式、簡化應用程式，並避免常見的程式代碼撰寫錯誤。