Freigeben über


IOleObject::GetMiscStatus-Methode (oleidl.h)

Ruft die status eines Objekts beim Erstellen und Laden ab.

Syntax

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

Parameter

[in] dwAspect

Der Aspekt eines Objekts, zu dem status Informationen angefordert werden. Der Wert wird aus der Enumeration DVASPECT abgerufen.

[out] pdwStatus

Ein Zeiger auf den Speicherort für die Rückgabe der Statusinformationen. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
OLE_S_USEREG
Delegieren Sie den Abruf verschiedener status Informationen an die Implementierung dieser Methode durch den Standardhandler.
CO_E_CLASSNOTREG
Für das Objekt ist keine CLSID registriert.
CO_E_READREGDB
Fehler beim Zugriff auf die Registrierung.

Hinweise

Ein Container ruft normalerweise IOleObject::GetMiscStatus auf, wenn er ein Objekt erstellt oder lädt, um zu bestimmen, wie das Objekt angezeigt werden soll und welche Verhaltenstypen er unterstützt.

Objekte speichern status Informationen in der Registrierung. Wenn das Objekt nicht ausgeführt wird, ruft die Implementierung von IOleObject::GetMiscStatus des Standardhandlers diese Informationen aus der Registrierung ab. Wenn das Objekt ausgeführt wird, ruft der Standardhandler IOleObject::GetMiscStatus für das Objekt selbst auf.

Die tatsächlich in der Registrierung gespeicherten Informationen variieren mit den einzelnen Objekten. Die status Werte, die zurückgegeben werden sollen, werden in der OLEMISC-Enumeration definiert.

Der Standardwert von IOleObject::GetMiscStatus wird verwendet, wenn kein Unterschlüssel gefunden wird, der dem angegebenen DVASPECT entspricht. Um ein OLE-Steuerelement festzulegen, geben Sie DVASPECT==1 an. Dies führt dazu, dass Folgendes in der Registrierung auftritt:

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

Hinweise zu Implementierern

Die Implementierung besteht normalerweise darin, den Aufruf an den Standardhandler zu delegieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile oleidl.h

Weitere Informationen

DVASPECT

FORMATETC

IOleObject

OLEMISC