AtlAxCreateControlLicEx

Artikel
03/01/2016

Erstellt ein lizenziertes ActiveX-Steuerelement, initialisiert und hostet es im angegebenen Fenster. Ein Schnittstellenzeiger und eine Ereignissenke für das neue Steuerelement können auch erstellt werden.

Wichtig

Diese Funktion kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.

Syntax

      ATLAPI AtlAxCreateControlLicEx(
LPCOLESTR lpszName, 
HWND hWnd, 
IStream* pStream,
IUnknown** ppUnkContainer, 
IUnknown** ppUnkControl,
REFIID iidSink = IID_NULL, 
IUnknown* punkSink = NULL, 
BSTR bstrLic= NULL
);

Parameter

lpszName
Ein Zeiger auf eine an das Steuerelement übergeben werden, Zeichenfolge. Muss in einer der folgenden Methoden formatiert werden:
- Ein ProgID wie "MSCAL.Calendar.7"
- Ein CLSID wie "{}" 8E27C92B-1264-101C-8A2F-040224009C02
- Eine URL wie "https://www.microsoft.com"
- Ein Verweis auf einen aktiven Dokument wie "file://\\Documents\MyDoc.doc"
- Ein Fragment von HTML wie "MSHTML:<HTML><BODY>Dies ist eine Zeile Text</BODY></HTML>"
  
  Hinweis
  
  "MSHTML: " muss dem HTML-Fragment vorausgehen, damit es als MSHTML-Stream festgelegt ist.
hWnd
Handle für das Fenster, dass das Steuerelement angefügt ist.
pStream
Ein Zeiger auf einen Stream, der verwendet wird, um die Eigenschaften des Steuerelements zu initialisieren. Kann NULL.
ppUnkContainer
Die Adresse eines Zeigers, der IUnknown des Containers empfängt. Kann NULL.
ppUnkControl
[out] die Adresse eines Zeigers, der IUnknown des erstellten Steuerelements empfängt. Kann NULL.
iidSink
Der Schnittstellenbezeichner einer Ausgangsschnittstelle auf dem enthaltenden Objekt.
punkSink
Ein Zeiger auf die IUnknown-Schnittstelle des an den Verbindungspunkt verbunden werden Senkenobjekts, angegeben durch iidSink auf dem enthaltenden Objekt, nachdem das enthaltende Objekt erfolgreich erstellt wurde.
bstrLic
Das BSTR, das die Lizenz für das Steuerelement enthält.

Rückgabewert

Einer der Werte des Standards HRESULT.

Hinweise

AtlAxCreateControlLicEx ist ähnlich, zu AtlAxCreateControlLic jedoch ermöglicht Ihnen auch, um einen Schnittstellenzeiger an die neu erstellte Steuerelement zu empfangen und eine Ereignissenke zu installieren, um die Ereignisse zu empfangen, die vom Steuerelement ausgelöst werden.

Beispiel

Siehe Hosten von ActiveX-Steuerelementen mit ATL AXHost für ein Beispiel dafür, wie AtlAxCreateControlLicEx verwendet.

Anforderungen

Header: atlhost.h

Siehe auch

Composite Control Global Functions
ATL-Grundlagen von zusammengesetzten Steuerelementen
AtlAxCreateControl
CAxWindow2T::CreateControlLicEx

Freigeben über