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 |