OleRegEnumVerbs-Funktion (ole2.h)
Stellt eine Enumeration der registrierten Verben für die angegebene Klasse bereit. Entwickler von benutzerdefinierten DLL-Objektanwendungen verwenden diese Funktion, um das Verhalten des Standardobjekthandlers zu emulieren.
Syntax
HRESULT OleRegEnumVerbs(
[in] REFCLSID clsid,
[out] LPENUMOLEVERB *ppenum
);
Parameter
[in] clsid
Klassenbezeichner, deren Verben angefordert werden.
[out] ppenum
Adresse der IEnumOLEVERB*-Zeigervariable, die den Schnittstellenzeiger auf das neue Enumerationsobjekt empfängt.
Rückgabewert
Diese Funktion gibt S_OK nach Erfolg zurück. Weitere mögliche Werte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Für die -Klasse werden keine Verben registriert. |
|
Für das Klassenobjekt ist keine CLSID registriert. |
|
Fehler beim Lesen der Registrierung. |
|
Der Schlüssel DataFormats/GetSet fehlt in der Registrierung. |
Hinweise
Objektanwendungen können OLE auffordern, ein Enumerationsobjekt für OLEVERB-Strukturen zu erstellen, um unterstützte Verben auf eine von zwei Arten aufzuzählen. Eine Möglichkeit besteht darin, OleRegEnumVerbs aufzurufen. Die andere Möglichkeit besteht darin, OLE_S_USEREG als Reaktion auf Aufrufe des Standardobjekthandlers an IOleObject::EnumVerbs zurückzugeben. OLE_S_USEREG weist den Standardhandler an, OleRegEnumVerbs aufzurufen. Da DLL-Objektanwendungen keine OLE_S_USEREG zurückgeben können, müssen sie OleRegEnumVerbs aufrufen, anstatt den Auftrag an den Objekthandler zu delegieren. Mit dem angegebenen IEnumOLEVERB-Zeiger auf das -Objekt können Sie die Standard-Enumerationsobjektmethoden aufrufen, um die Enumeration zu erledigen.
Die OleRegEnumVerbs-Funktion und ihre gleichgeordneten Funktionen OleRegGetUserType, OleRegGetMiscStatus und OleRegEnumFormatEtc 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
| 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 | 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) |