列舉目前容器中的物件。
語法
HRESULT EnumObjects(
[in] DWORD grfFlags,
[out] IEnumUnknown **ppenum
);
參數
[in] grfFlags
指定要列舉容器中的物件,如列舉 OLECONTF 中所定義。
[out] ppenum
IEnumUnknown 指標變數的指標,可接收列舉值物件的介面指標。 每次容器收到成功呼叫 EnumObjects 時,它必須增加方法傳回之 ppenum 指標上的參考計數。 呼叫者必須負責在完成指標時呼叫 IUnknown::Release 。 如果傳回錯誤,實作必須將 ppenum 設定為 NULL。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
作業失敗。 |
|
不支援物件列舉。 |
備註
容器應該實作 EnumObjects ,讓程式設計用戶端找出其保留的物件。 不過,在標準連結案例中不會呼叫這個方法。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | oleidl.h |