IPropertyStorage：：ReadPropertyNames 方法 (propidlbase.h)

ReadPropertyNames方法會擷取指定屬性識別碼的任何現有字串名稱。

語法

HRESULT ReadPropertyNames(
  [in]      ULONG           cpropid,
  [in]      const PROPID [] rgpropid,
  [in, out] LPOLESTR []     rglpwstrName
);

參數

[in] cpropid

陣列 rgpropid輸入上的專案數目。 這個參數的值可以設定為零，但是因為不會讀取任何屬性名稱，所以會破壞這個方法的目的。

[in] rgpropid

要擷取名稱的屬性識別碼陣列。

[in, out] rglpwstrName

LPWSTR成員大小cpropid的呼叫端配置陣列。 傳回時，實作會填入此陣列。 指定的專案包含屬性識別碼的對應字串名稱，如果屬性識別碼沒有字串名稱，則它可以是空的。

陣列的每個 LPWSTR 成員都應該使用 CoTaskMemFree 函式釋放。

傳回值

除了下列專案之外，這個方法還支援標準傳回值E_UNEXPECTED：

備註

針對 rgpropid 陣列中提供之屬性識別碼清單中的每個屬性識別碼， ReadPropertyNames 會擷取對應的字串名稱，如果有的話。 建立屬性時，或透過呼叫IPropertyStorage：：WritePropertyStorage：：WritePropertyNames來建立字串名稱。 不論是哪一種情況，字串名稱都是選擇性的，不過所有屬性都必須有屬性識別碼。

對應至屬性識別碼的字串名稱在集合內必須是唯一的。

需求

另請參閱

IPropertyStorage

IPropertyStorage：：WriteMultiple

IPropertyStorage：：WritePropertyNames