AtlAxCreateControlLicEx
Cria um controle ActiveX licenciado, inicializa-o, e hospedá-lo na janela especificada. Um ponteiro e um coletor de eventos da interface para o novo controle também podem ser criados.
Importante
Essa função não pode ser usada em aplicativos executados em Tempo de Execução do Windows.
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 cadeia de caracteres a ser passado para o controle. Deve ser formatado em uma das seguintes maneiras:ProgID como “MSCAL.Calendar.7”
Um CLSID como “{}” 8E27C92B-1264-101C-8A2F-040224009C02
UM URL como “https://www.microsoft.com”
Uma referência a um documento ativo como “file://\\Documents\MyDoc.doc”
Um fragmento HTML como “MSHTML:<HTML><BODY>isso é uma linha de texto</BODY></HTML>”
Dica
“MSHTML: ” deve preceder o fragmento HTML de modo que é designado como ser um fluxo de MSHTML.
hWnd
Identificador para a janela que o controle será associado.pStream
Um ponteiro para um fluxo que é usado para inicializar propriedades do controle. Pode ser NULO.ppUnkContainer
O endereço de um ponteiro que recebe IUnknown do recipiente. Pode ser NULO.ppUnkControl
[out] o endereço de um ponteiro que recebe IUnknown de controle criado. Pode ser NULO.iidSink
O identificador da interface de uma interface de saída contido no objeto.punkSink
Um ponteiro para a interface de IUnknown do coletor a ser conectado ao ponto de conexão especificado por iidSink contido no objeto depois que o objeto contido foi criado com êxito.bstrLic
O BSTR que contém a licença para o controle.
Valor de retorno
Um dos valores padrão do HRESULT.
Comentários
AtlAxCreateControlLicEx é semelhante a AtlAxCreateControlLic mas também permite que você receber um ponteiro de interface para o controle recém-criado e configurar um coletor de eventos para receber eventos acionados pelo controle.
Exemplo
Hospedando controles ActiveX usando ATL AXHost consulte para um exemplo de como usar AtlAxCreateControlLicEx.
Requisitos
Cabeçalho: atlhost.h
Consulte também
Referência
CAxWindow2T::CreateControlLicEx
Conceitos
Fundamentos do controle composto ATL