OleRegGetUserType-Funktion (ole2.h)
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 |
|---|---|
|
Der Benutzertyp wurde erfolgreich zurückgegeben. |
|
Für das Klassenobjekt ist keine CLSID registriert. |
|
Fehler beim Lesen aus der Registrierung. |
|
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) |