OleRegEnumVerbs-Funktion (ole2.h)

  • Artikel

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
OLEOBJ_E_NOVERBS
 Für die -Klasse werden keine Verben registriert.
REGDB_E_CLASSNOTREG
 Für das Klassenobjekt ist keine CLSID registriert.
REGDB_E_READREGDB
 Fehler beim Lesen der Registrierung.
OLE_E_REGDB_KEY
 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)

Weitere Informationen

IEnumOLEVERB

IOleObject::EnumVerbs