共用方式為


IPropertyStorage::ReadMultiple 方法 (propidl.h)

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

另請參閱

EnumAll 範例

IPropertySetStorage

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames

範例

StgCreatePropSetStg 範例

WriteRead 範例