OleRegGetMiscStatus-Funktion (ole2.h)
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 |
|---|---|
|
Die status Informationen wurden erfolgreich zurückgegeben. |
|
Für das Klassenobjekt ist keine CLSID registriert. |
|
Fehler beim Lesen aus der Registrierung. |
|
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) |