OleRegEnumVerbs 函式 (ole2.h)
提供所指定類別之已註冊動詞命令的列舉。 自定義 DLL 物件應用程式的開發人員會使用此函式來模擬預設物件處理程序的行為。
語法
HRESULT OleRegEnumVerbs(
[in] REFCLSID clsid,
[out] LPENUMOLEVERB *ppenum
);
參數
[in] clsid
要求其動詞的類別標識碼。
[out] ppenum
接收新列舉物件介面指標的 IEnumOLEVERB* 指標變數位址。
傳回值
此函式會在成功時傳回S_OK。 其他可能的值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
類別不會註冊任何動詞。 |
|
未為類別物件註冊任何 CLSID。 |
|
讀取登錄時發生錯誤。 |
|
登錄中遺漏 DataFormats/GetSet 機碼。 |
備註
物件應用程式可以要求 OLE 建立 OLEVERB 結構的列舉物件，以兩種方式之一列舉支援的動詞。 其中一種方式是呼叫 OleRegEnumVerbs。 另一種方式是傳回OLE_S_USEREG，以回應 IOleObject：：EnumVerbs 的默認物件處理程式呼叫。 OLE_S_USEREG會指示默認處理程式呼叫 OleRegEnumVerbs。 因為 DLL 物件應用程式無法傳回OLE_S_USEREG，所以它們必須呼叫 OleRegEnumVerbs ，而不是將作業委派給對象處理程式。 透過提供物件的 IEnumOLEVERB 指標，您可以呼叫標準列舉物件方法來執行列舉。
OleRegEnumVerbs 函式及其同層級函式 OleRegGetUserType、OleRegGetMiscStatus 和 OleRegEnumFormatEtc 提供一種方式，讓自定義 DLL 物件應用程式的開發人員模擬從登錄取得物件的相關信息時，OLE 的默認對象處理程序行為。 藉由使用這些函式，您可以避免撰寫自己的大量工作，以及直接在登錄中運作時固有的陷阱。 此外，您不需要自行撰寫程序代碼，即可取得這些函式的未來增強功能和優化。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | ole2.h |
| 程式庫 | Ole32.lib |
| Dll | Ole32.dll |
| API 集合 | ext-ms-win-com-ole32-l1-1-3 (Windows 10 10.0.10240 版) |