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 |