Condividi tramite


AtlAxCreateControlEx

Crea un controllo ActiveX, 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 AtlAxCreateControlEx( 
LPCOLESTR lpszName, 
HWND hWnd, 
IStream* pStream, 
IUnknown** ppUnkContainer, 
IUnknown** ppUnkControl, 
REFIID iidSink = IID_NULL, 
IUnknown* punkSink = 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
    [in] handle della finestra che il controllo verrà associato.

  • pStream
    [in] puntatore A un flusso utilizzato per inizializzare le proprietà del controllo. Può essere NULL.

  • ppUnkContainer
    [out] 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.

Valore restituito

Uno dei valori HRESULT standard.

Note

AtlAxCreateControlEx è simile a AtlAxCreateControl 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.

Per creare un controllo ActiveX con licenza, vedere AtlAxCreateControlLicEx.

Requisiti

Header: atlhost.h

Vedere anche

Riferimenti

CAxWindow::CreateControlEx

Concetti

Nozioni fondamentali sul controllo composito di ATL

Altre risorse

Composite Control Global Functions