共用方式為


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來建立字串名稱。 不論是哪一種情況,字串名稱都是選擇性的,不過所有屬性都必須有屬性識別碼。

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

需求

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

另請參閱

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames