OleRegGetUserType-Funktion (ole2.h)

  • Artikel

Ruft den Benutzertyp der angegebenen Klasse aus der Registrierung ab.

Entwickler von benutzerdefinierten DLL-Objektanwendungen verwenden diese Funktion, um das Verhalten des OLE-Standardhandlers zu emulieren.

Syntax

HRESULT OleRegGetUserType(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwFormOfType,
  [out] LPOLESTR *pszUserType
);

Parameter

[in] clsid

Die CLSID der Klasse, für die der Benutzertyp angefordert werden soll.

[in] dwFormOfType

Die Form der benutzerdefinierten Zeichenfolge. Mögliche Werte stammen aus der Enumeration USERCLASSTYPE.

[out] pszUserType

Ein Zeiger auf eine Zeichenfolge, die den Benutzertyp empfängt.

Rückgabewert

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

Rückgabecode BESCHREIBUNG
S_OK
 Der Benutzertyp wurde 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
 Die Schlüssel ProgID = MainUserTypeName und CLSID = MainUserTypeName fehlen in der Registrierung.

Hinweise

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

Die OleRegGetUserType-Funktion und ihre gleichgeordneten Funktionen OleRegGetMiscStatus, OleRegEnumFormatEtc und OleRegEnumVerbs bieten Entwicklern benutzerdefinierter DLL-Objektanwendungen die 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

IOleObject::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus