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.

Nota importanteImportante

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 di base del controllo composito

Altre risorse

Funzioni globali del controllo composito