PSPropertyBag_ReadStrAlloc函式 (propsys.h)

從屬性包中的屬性讀取字串數據值，併為讀取的字串配置記憶體。

語法

PSSTDAPI PSPropertyBag_ReadStrAlloc(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] PWSTR        *value
);

[in] propBag

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

[in] propName

類型： LPCWSTR

Null 終止屬性名稱字串的指標。

[out] value

類型： PWSTR*

當此函式傳回時，會包含屬性包中屬性之字串數據值的指標，併為讀取的字串配置記憶體。 PSPropertyBag_ReadStrAlloc函式的呼叫端必須在此參數上呼叫 CoTaskMemFree 函式。

類型： HRESULT

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

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