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
OLEOBJ_E_NOVERBS	No hay verbos registrados para la clase .
REGDB_E_CLASSNOTREG	No se registra CLSID para el objeto de clase.
REGDB_E_READREGDB	Error al leer el registro.
OLE_E_REGDB_KEY	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)

Consulte también

IEnumOLEVERB

IOleObject::EnumVerbs