IMoniker：：Enum 方法 (objidl.h)

發行項
03/05/2024

擷取複合Moniker元件之列舉值的指標。

語法

HRESULT Enum(
  [in]  BOOL         fForward,
  [out] IEnumMoniker **ppenumMoniker
);

參數

[in] fForward

如果 為 TRUE，請從左至右列舉 Monikers。如果 為 FALSE，請從右至左列舉。

[out] ppenumMoniker

IEnumMoniker 指標變數的指標，可接收Moniker列舉值物件的介面指標。成功時，實作必須在列舉值物件上呼叫 AddRef 。呼叫者必須負責呼叫 Release。如果發生錯誤，或Moniker沒有可列舉的元件，則實作會將 *ppenumMoniker 設定為 NULL。

傳回值

這個方法可以傳回標準傳回值E_OUTOFMEMORY、E_UNEXPECTED和S_OK。

備註

這個方法必須提供可列舉Moniker元件的列舉值 IEnumMoniker 指標。例如，泛型複合 Moniker的IMoniker：：Enum 方法實作會建立列舉值，以判斷組成復合的個別Moniker，而檔案Moniker的 IMoniker：：Enum 方法會建立列舉值，以傳回代表路徑中每個元件的Monikers。

來電者的附註

呼叫此方法來檢查組成複合Moniker的元件。

實作者的注意事項

如果新的Moniker類別沒有可辨識的內部結構，則此方法的實作可以直接傳回S_OK，並將 ppenumMoniker 設定為 NULL。

實作特定附注

實作	備註
反Moniker	這個方法會傳回S_OK，並將 ppenumMoniker 設定為 NULL。
類別Moniker	這個方法會傳回S_OK，並將 ppenumMoniker 設定為 NULL。
檔案Moniker	這個方法會傳回S_OK，並將 ppenumMoniker 設定為 NULL。
泛型複合Moniker	如果成功，此方法會傳回S_OK，並傳回列舉組成複合元件Monikers的列舉值;否則，方法會傳回E_OUTOFMEMORY。
專案Moniker	這個方法會傳回S_OK，並將 ppenumMoniker 設定為 NULL。
OBJREF Moniker	這個方法會傳回S_OK，並將 ppenumMoniker 設定為 NULL。
指標 Moniker	這個方法會傳回E_NOTIMPL。
URL Moniker	這個方法會傳回S_OK，並將 ppenumMoniker 設定為 NULL。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	objidl.h

另請參閱

IEnumMoniker

IMoniker