Función OleRegEnumVerbs (ole2.h)
Proporciona una enumeración de los verbos registrados para la clase especificada. Los desarrolladores de aplicaciones de objetos DLL personalizadas usan esta función para emular el comportamiento del controlador de objetos predeterminado.
Sintaxis
HRESULT OleRegEnumVerbs(
[in] REFCLSID clsid,
[out] LPENUMOLEVERB *ppenum
);
Parámetros
[in] clsid
Identificador de clase cuyos verbos se solicitan.
[out] ppenum
Dirección de la variable de puntero IEnumOLEVERB* que recibe el puntero de interfaz al nuevo objeto de enumeración.
Valor devuelto
Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.
| Código devuelto | Descripción |
|---|---|
|
No hay verbos registrados para la clase . |
|
No se registra CLSID para el objeto de clase. |
|
Error al leer el registro. |
|
Falta la clave DataFormats/GetSet en el Registro. |
Comentarios
Las aplicaciones de objeto pueden pedir a OLE que cree un objeto de enumeración para estructuras OLEVERB para enumerar los verbos admitidos de una de dos maneras. Una manera es llamar a OleRegEnumVerbs. La otra manera es devolver OLE_S_USEREG en respuesta a las llamadas del controlador de objetos predeterminado a IOleObject::EnumVerbs. OLE_S_USEREG indica al controlador predeterminado que llame a OleRegEnumVerbs. Dado que las aplicaciones de objetos DLL no pueden devolver OLE_S_USEREG, deben llamar a OleRegEnumVerbs en lugar de delegar el trabajo en el controlador de objetos. Con el puntero IEnumOLEVERB proporcionado al objeto, puede llamar a los métodos de objeto de enumeración estándar para realizar la enumeración.
La función OleRegEnumVerbs y sus funciones del mismo nivel, OleRegGetUserType, OleRegGetMiscStatus y OleRegEnumFormatEtc, proporcionan una manera para que los desarrolladores de aplicaciones de objetos DLL personalizadas emulen el comportamiento del controlador de objetos predeterminado de OLE para obtener información sobre los objetos del Registro. Al usar estas funciones, se evita el trabajo considerable de escritura propio y las dificultades inherentes a trabajar directamente en el registro. Además, obtendrá futuras mejoras y optimizaciones de estas funciones sin tener que codificarlas usted mismo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ole2.h |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |
| Conjunto de API | ext-ms-win-com-ole32-l1-1-3 (introducido en Windows 10, versión 10.0.10240) |