Compartilhar via


AtlAxCreateControlLicEx

Cria um controle ActiveX licenciado, inicializa e hospeda-lo na janela especificada.Também é possível criar um coletor de ponteiro e o evento de interface para o novo controle.

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

Parâmetros

  • lpszName
    Um ponteiro para uma seqüência de caracteres a ser passada para o controle.Deve ser formatado em uma das seguintes maneiras:

    • ProgID, sistema autônomo "MSCAL.calendário.7"

    • Um CLSID sistema autônomo "{8E27C92B-1264-101 - 8A2F - C 040224009C02}"

    • Uma URL, sistema autônomo "https://www.microsoft.com"

    • Uma referência a um documento ativo sistema autônomo "arquivo://\\Documents\MyDoc.doc"

    • Um fragmento de HTML, sistema autônomo "MSHTML: <html><body>Esta é uma linha de texto</body></html>"

      Observação:

      "MSHTML:" deve preceder o fragmento de HTML para que ele é designado sistema autônomo sendo um strea MSHTML m.

  • hWnd
    Identificador para a janela que o controle será anexado ao.

  • pStream
    Um ponteiro para um fluxo é usado para inicializar as propriedades do controle.Pode ser NULO.

  • ppUnkContainer
    O endereço de um ponteiro que receberá o IUnknown do contêiner.Pode ser NULO.

  • ppUnkControl
    [out] O endereço de um ponteiro que receberá o IUnknown do controle criado.Pode ser NULO.

  • iidSink
    O identificador de interface de uma interface de saída no objeto contido.

  • punkSink
    Um ponteiro para o IUnknown interface do objeto coletor a ser conectado ao ponto de conexão especificado por iidSink no objeto contido após o objeto contido, foi criado com êxito.

  • bstrLic
    BSTR que contém a licença para o controle.

Valor de retorno

Um dos valores HRESULT padrão.

Comentários

AtlAxCreateControlLicEx é semelhante a AtlAxCreateControlLic mas também permite que você receber um ponteiro de interface para o controle recém-criado e configurado um coletor de evento para receber eventos acionados pelo controle.

Exemplo

See Hospedagem de controles ActiveX usando AXHost ATL para obter um exemplo de como usar AtlAxCreateControlLicEx.

Requisitos

Cabeçalho: atlhost.h

Consulte também

Conceitos

Conceitos básicos de controle composto

Referência

AtlAxCreateControl

CAxWindow2T::CreateControlLicEx

Outros recursos

Controle composto funções global