IPropertyStorage：：ReadPropertyNames 方法 (propidl.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：：WritePropertyNames 來指定呼叫 IPropertyStorage：：WriteMultiple 來建立字元串名稱。 不論是哪一種情況，字串名稱都是選擇性的，不過所有屬性都必須有屬性標識符。

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 propidl.h (包括 Objbase.h、Propidlbase.h)
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

IPropertyStorage

IPropertyStorage：：WriteMultiple

IPropertyStorage：：WritePropertyNames