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.

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

Consulte también

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType