OleRegGetMiscStatus-Funktion (ole2.h)

Artikel
08/25/2023

Gibt verschiedene Informationen über die Präsentation und das Verhalten zurück, die von der angegebenen CLSID aus der Registrierung unterstützt werden.

Diese Funktion wird von Entwicklern benutzerdefinierter DLL-Objektanwendungen verwendet, um das Verhalten des OLE-Standardhandlers zu emulieren.

Syntax

HRESULT OleRegGetMiscStatus(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwAspect,
  [out] DWORD    *pdwStatus
);

Parameter

[in] clsid

Die CLSID der Klasse, für die status Informationen angefordert werden sollen.

[in] dwAspect

Der Präsentationsaspekt der Klasse, für die Informationen angefordert werden. Mögliche Werte stammen aus der DVASPECT-Enumeration .

[out] pdwStatus

Ein Zeiger auf die Variable, die die status Informationen empfängt.

Rückgabewert

Diese Funktion kann den Standardrückgabewert E_OUTOFMEMORY sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die status Informationen wurden erfolgreich zurückgegeben.
REGDB_E_CLASSNOTREG	Für das Klassenobjekt ist keine CLSID registriert.
REGDB_E_READREGDB	Fehler beim Lesen aus der Registrierung.
OLE_E_REGDB_KEY	Der Schlüssel GetMiscStatus fehlt in der Registrierung.

Hinweise

Objektanwendungen können OLE auf zwei Arten bitten, verschiedene status Informationen abzurufen. Eine Möglichkeit besteht darin, OleRegGetMiscStatus aufzurufen. Die andere besteht darin, OLE_S_USEREG als Reaktion auf Aufrufe des Standardobjekthandlers an IOleObject::GetMiscStatus zurückzugeben. OLE_S_USEREG weist den Standardhandler an, OleRegGetMiscStatus aufzurufen. Da DLL-Objektanwendungen keine OLE_S_USEREG zurückgeben können, müssen sie OleRegGetMiscStatus aufrufen, anstatt den Auftrag an den Objekthandler zu delegieren.

OleRegGetMiscStatus und seine gleichgeordneten Funktionen OleRegGetUserType, OleRegEnumFormatEtc und OleRegEnumVerbs bieten Entwicklern benutzerdefinierter DLL-Objektanwendungen eine Möglichkeit, das Verhalten des Standardobjekthandlers von OLE beim Abrufen von Informationen zu Objekten aus der Registrierung zu emulieren. Durch die Verwendung dieser Funktionen vermeiden Sie die erhebliche Arbeit, ihre eigenen zu schreiben, und die Fallstricke, die bei der arbeit direkt in der Registrierung innewohnen. Darüber hinaus erhalten Sie zukünftige Erweiterungen und Optimierungen dieser Funktionen, ohne sie selbst programmieren zu müssen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ole2.h
Bibliothek	Ole32.lib
DLL	Ole32.dll
APIs	ext-ms-win-com-ole32-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType