IPropertyStorage：：ReadMultiple 方法 (propidl.h)

發行項
03/01/2024

ReadMultiple 方法會從目前屬性集讀取指定的屬性。

語法

HRESULT ReadMultiple(
  [in]  ULONG             cpspec,
  [in]  const PROPSPEC [] rgpspec,
  [out] PROPVARIANT []    rgpropvar
);

參數

[in] cpspec

要指定於 rgpspec 陣列中的屬性數值計數。此參數的值可以設定為零;不過，不論 rgpspec 中設定的值為何，這都會破壞方法的目的，因為不會讀取任何屬性。

[in] rgpspec

PROPSPEC 結構的陣列會指定要讀取的屬性。屬性可以透過屬性識別碼或選擇性字串名稱來指定。不需要以數位中的任何特定順序指定屬性。數位可以包含重複的屬性，因此會針對簡單屬性傳回重複屬性值。非簡單屬性應該會在嘗試第二次開啟時傳回拒絕存取。數位可以包含屬性識別元和字串標識碼的混合。

[out] rgpropvar

在傳回時， PROPVARIANT 結構的呼叫端配置陣列包含 rgpspec 陣列中對應元素所指定的屬性值。陣列必須至少夠大，才能保存 PROPVARIANT 結構的 cpspec 參數值。 cpspec 參數會指定數位中設定的屬性數目。呼叫端不需要以任何特定順序初始化這些 PROPVARIANT 結構值。不過，實作必須在傳回時正確填入所有成員。如果沒有其他適當的值，實作必須將每個 PROPVARIANT 結構的 vt 成員設定為VT_EMPTY。

傳回值

這個方法支持標準傳回值 E_UNEXPECTED，以及下列專案：

此函式也可以傳回任何檔案系統錯誤或包裝在 HRESULT 資料類型中的 Win32 錯誤。如需詳細資訊，請參閱錯誤處理策略。

如需詳細資訊，請參閱屬性記憶體考慮。

規格需求

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