IOleObject::GetMiscStatus-Methode (oleidl.h)

Artikel
03/01/2024

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