OleCreateDefaultHandler-Funktion (ole2.h)
Erstellt eine neue instance des Standardeinbettungshandlers. Diese instance wird initialisiert, sodass ein lokaler Server erstellt wird, wenn das eingebettete Objekt in den Ausführungszustand wechselt.
Syntax
HRESULT OleCreateDefaultHandler(
[in] REFCLSID clsid,
[in] LPUNKNOWN pUnkOuter,
[in] REFIID riid,
[out] LPVOID *lplpObj
);
Parameter
[in] clsid
CLSID, die den OLE-Server identifiziert, der geladen werden soll, wenn das eingebettete Objekt in den Ausführungszustand wechselt.
[in] pUnkOuter
Zeiger auf die steuernde IUnknown-Schnittstelle , wenn der Handler aggregiert werden soll; NULL , wenn es nicht aggregiert werden soll.
[in] riid
Verweis auf den Bezeichner der Schnittstelle, in der Regel IID_IOleObject, über den der Aufrufer mit dem Handler kommuniziert.
[out] lplpObj
Adresse der Zeigervariable, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvObj den angeforderten Schnittstellenzeiger für den neu erstellten Handler.
Rückgabewert
Diese Funktion gibt NOERROR bei Erfolg zurück und unterstützt den Standardrückgabewert E_OUTOFMEMORY.
Hinweise
OleCreateDefaultHandler erstellt eine neue instance des Standardeinbettungshandlers, der initialisiert wird, sodass ein lokaler Server erstellt wird, der durch den clsid-Parameter identifiziert wird, wenn das eingebettete Objekt in den Ausführungszustand wechselt. Wenn Sie einen Handler schreiben und die Dienste des Standardhandlers verwenden möchten, rufen Sie OleCreateDefaultHandler auf. OLE ruft sie auch intern auf, wenn die in einem Aufruf der Objekterstellung angegebene CLSID nicht registriert ist.
Wenn die angegebene Klasse keinen speziellen Handler aufweist, erzeugt ein Aufruf von OleCreateDefaultHandler die gleichen Ergebnisse wie ein Aufruf der CoCreateInstance-Funktion , wobei dem Klassenkontextparameter der Wert CLSCTX_INPROC_HANDLER zugewiesen ist.
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 |