Condividi tramite


AtlAxCreateControlLicEx

Crea un controllo ActiveX con licenza, la inizializza e lo ospita nella finestra specificata. Un puntatore a interfaccia e un sink di evento per il nuovo controllo possono essere creati.

Importante

Questa funzione non può essere utilizzata nelle applicazioni eseguite in Windows Runtime.

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

Parametri

  • lpszName
    Un puntatore a una stringa da passare al controllo. Deve essere formattato in uno dei modi seguenti:

    • Un ProgID come "MSCAL.Calendar.7"

    • Un CLSID come "{}" 8E27C92B-1264-101C-8A2F-040224009C02

    • Un URL come "https://www.microsoft.com"

    • Un riferimento a un documento attivo in "file://\\Documents\MyDoc.doc"

    • Un frammento di codice HTML come "MSHTML:<HTML><BODY>questo è una riga di text</body></html>"

      Nota

      "MSHTML: " deve precedere il codice HTML in modo da definirlo di come un flusso di MSHTML.

  • hWnd
    Handle della finestra che il controllo verrà associato.

  • pStream
    Un puntatore a un flusso utilizzato per inizializzare le proprietà del controllo. Può essere NULL.

  • ppUnkContainer
    L'indirizzo di un puntatore che riceverà IUnknown del contenitore. Può essere NULL.

  • ppUnkControl
    [out] indirizzo di un puntatore che riceverà IUnknown del controllo creato. Può essere NULL.

  • iidSink
    Identificatore di interfaccia di un'interfaccia in uscita all'oggetto contenuto.

  • punkSink
    Un puntatore a un'interfaccia IUnknown dell'oggetto sink per connettersi al punto di connessione specificato da iidSink l'oggetto contenuto dopo che l'oggetto contenuto è stato creato correttamente.

  • bstrLic
    La stringa BSTR contenente la licenza per il controllo.

Valore restituito

Uno dei valori HRESULT standard.

Note

AtlAxCreateControlLicEx è simile a AtlAxCreateControlLic ma anche che consente di ricevere un puntatore a interfaccia al controllo appena creata e installare un sink di evento per ricevere eventi generati dal controllo.

Esempio

Vedere Controlli ActiveX di hosting mediante ATL AXHost per un esempio di come utilizzare AtlAxCreateControlLicEx.

Requisiti

Header: atlhost.h

Vedere anche

Riferimenti

AtlAxCreateControl

CAxWindow2T::CreateControlLicEx

Concetti

Nozioni fondamentali sul controllo composito di ATL

Altre risorse

Composite Control Global Functions