Función OleRegGetMiscStatus (ole2.h)
Devuelve información varias sobre la presentación y los comportamientos admitidos por el CLSID especificado del Registro.
Los desarrolladores de aplicaciones de objetos DLL personalizados usan esta función para emular el comportamiento del controlador predeterminado OLE.
Sintaxis
HRESULT OleRegGetMiscStatus(
[in] REFCLSID clsid,
[in] DWORD dwAspect,
[out] DWORD *pdwStatus
);
Parámetros
[in] clsid
CLSID de la clase para la que se va a solicitar información de estado.
[in] dwAspect
Aspecto de presentación de la clase para la que se solicita información. Los valores posibles se toman de la enumeración DVASPECT .
[out] pdwStatus
Puntero a la variable que recibe la información de estado.
Valor devuelto
Esta función puede devolver el valor devuelto estándar E_OUTOFMEMORY, así como los siguientes valores.
| Código devuelto | Descripción |
|---|---|
|
La información de estado se devolvió correctamente. |
|
No se registra CLSID para el objeto de clase. |
|
Error al leer el registro. |
|
Falta la clave GetMiscStatus en el Registro. |
Comentarios
Las aplicaciones de objeto pueden pedir a OLE que obtenga información de estado varios de dos maneras. Una manera es llamar a OleRegGetMiscStatus. El otro es devolver OLE_S_USEREG en respuesta a las llamadas del controlador de objetos predeterminado a IOleObject::GetMiscStatus. OLE_S_USEREG indica al controlador predeterminado que llame a OleRegGetMiscStatus. Dado que las aplicaciones de objetos DLL no pueden devolver OLE_S_USEREG, deben llamar a OleRegGetMiscStatus en lugar de delegar el trabajo en el controlador de objetos.
OleRegGetMiscStatus y sus funciones del mismo nivel, OleRegGetUserType, OleRegEnumFormatEtc y OleRegEnumVerbs, 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
| 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) |