OleCreateDefaultHandler-Funktion (ole2.h)

  • Artikel

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

Weitere Informationen

CLSCTX

Cocreateinstance