PSPropertyBag_ReadStr函式 (propsys.h)
讀取屬性包中屬性的字串數據值。
語法
PSSTDAPI PSPropertyBag_ReadStr(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] LPWSTR value,
[out] int characterCount
);
參數
[in] propBag
類型： IPropertyBag*
IPropertyBag 物件的指標，代表儲存屬性的屬性包。
[in] propName
類型： LPCWSTR
以 Null 結尾的屬性名稱字串。
[out] value
類型： LPCWSTR
當此函式傳回時，會包含字串屬性值的指標。
[out] characterCount
類型： int
此函式會傳回整數，代表傳回之 value 參數) 的最大字元數 (大小。
傳回值
類型： HRESULT
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
屬性包屬性函式 API 會在視窗類型與用來表示屬性包中值的 VARIANT 類型之間轉換。 這麼做可簡化屬性包的使用方式、簡化應用程式，並避免常見的程式代碼撰寫錯誤。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | propsys.h |
| 程式庫 | Propsys.lib |
| Dll | Propsys.dll (6.0 版或更新版本) |