Compartilhar via


AtlAxCreateControl

Cria um controle ActiveX, inicializa-o, e hospedá-lo na janela especificada.

Observação importanteImportante

Essa função não pode ser usada em aplicativos executados em Tempo de Execução do Windows.

ATLAPI AtlAxCreateControl(
LPCOLESTR lpszName,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnkContainer 
);

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>”

      ObservaçãoObservação

      “MSHTML: ” deve preceder o fragmento HTML de modo que é designado como ser um fluxo de MSHTML.

  • hWnd
    [in] identificador para a janela que o controle será associado.

  • pStream
    [in] um ponteiro à um fluxo que é usado para inicializar propriedades do controle.Pode ser NULO.

  • ppUnkContainer
    [out] o endereço de um ponteiro que recebe IUnknown do recipiente.Pode ser NULO.

Valor de retorno

Um dos valores padrão do HRESULT.

Comentários

Essa função global do mesmo resultado que chamar AtlAxCreateControlEx( lpszName**,** hWnd**,** pStream**, NULL, NULL, NULL, NULL** );.

Para criar um controle ActiveX licenciado, consulte AtlAxCreateControlLic.

Requisitos

Cabeçalho: atlhost.h

Consulte também

Referência

CAxWindow::CreateControl

Conceitos

Fundamentos controle composto

Outros recursos

Funções globais de controle composto