共用方式為


IStorage::EnumElements 方法 (objidl.h)

EnumElements 方法會擷取列舉值物件的指標,可用來列舉此儲存物件中包含的儲存和數據流物件。

語法

HRESULT EnumElements(
  [in]  DWORD        reserved1,
  [in]  void         *reserved2,
  [in]  DWORD        reserved3,
  [out] IEnumSTATSTG **ppenum
);

參數

[in] reserved1

保留以備將來之用;必須為零。

[in] reserved2

保留供日後使用;必須是 NULL

[in] reserved3

保留以備將來之用;必須為零。

[out] ppenum

接收新列舉值物件的介面指標 IEnumSTATSTG* 指標變數。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK 已成功傳回列舉值物件。
E_PENDING 僅限異步記憶體:目前無法使用部分或所有元素的數據。
STG_E_INSUFFICIENTMEMORY 因為記憶體不足,所以無法建立列舉值物件。
STG_E_INVALIDPARAMETER 其中一個參數無效。
STG_E_REVERTED 記憶體物件已因交易樹狀結構中上方的還原作業而失效。

備註

這個方法傳回的列舉值物件會實作 IEnumSTATSTG 介面,這是其中一個標準列舉值介面,其中包含 NextResetCloneSkip 方法。 IEnumSTATSTG 會列舉儲存在 STATSTG 結構陣列中的數據。

記憶體對象必須以讀取模式開啟,才能允許列舉其元素。

允許列舉值物件以任何順序列舉專案。 列舉值物件也允許將列舉視為快照集,或讓列舉反映記憶體物件的目前狀態。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objidl.h
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

IEnumSTATSTG

IStorage - 複合檔案實作

STATSTG