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 介面，這是其中一個標準列舉值介面，其中包含 Next、 Reset、 Clone 和 Skip 方法。 IEnumSTATSTG 會列舉儲存在 STATSTG 結構陣列中的數據。

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

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

規格需求

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

另請參閱

IEnumSTATSTG

IStorage - 複合檔案實作

STATSTG