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 |