Método IOleObject::GetMiscStatus (oleidl.h)

  • Artículo

Recupera el estado de un objeto al crear y cargar.

Sintaxis

HRESULT GetMiscStatus(
  [in]  DWORD dwAspect,
  [out] DWORD *pdwStatus
);

Parámetros

[in] dwAspect

Aspecto de un objeto sobre el que se solicita información de estado. El valor se obtiene de la enumeración DVASPECT.

[out] pdwStatus

Puntero al que se devuelve la información de estado. Este parámetro no puede ser NULL.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
OLE_S_USEREG
 Delegue la recuperación de información de estado varios en la implementación del controlador predeterminado de este método.
CO_E_CLASSNOTREG
 No hay ningún CLSID registrado para el objeto .
CO_E_READREGDB
 Error al acceder al registro.

Comentarios

Normalmente, un contenedor llama a IOleObject::GetMiscStatus cuando crea o carga un objeto para determinar cómo mostrar el objeto y qué tipos de comportamientos admite.

Los objetos almacenan información de estado en el Registro. Si el objeto no se está ejecutando, la implementación del controlador predeterminado de IOleObject::GetMiscStatus recupera esta información del Registro. Si el objeto se está ejecutando, el controlador predeterminado invoca IOleObject::GetMiscStatus en el propio objeto.

La información que se almacena realmente en el registro varía con objetos individuales. Los valores de estado que se van a devolver se definen en la enumeración OLEMISC.

El valor predeterminado de IOleObject::GetMiscStatus se usa si no se encuentra una subclave correspondiente al DVASPECT especificado. Para establecer un control OLE, especifique DVASPECT==1. Esto hará que se produzca lo siguiente en el registro:

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

Notas para los implementadores

La implementación normalmente consiste en delegar la llamada al controlador predeterminado.

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 oleidl.h

Consulte también

DVASPECT

FORMATETC

IOleObject

OLEMISC