Partilhar via


Inicialização OLE

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Antes de uma aplicação poder utilizar os serviços do sistema OLE, deve inicializar as DLLs do sistema OLE e verificar se as DLLs são a versão correta. A AfxOleInit função inicializa as DLLs do sistema OLE.

Inicialização OLE

Nome Description
AfxOleInit Inicializa as bibliotecas OLE.
AfxEnableControlContainer Chame esta função na função do InitInstance seu objeto de aplicação para permitir o suporte de contenção de controlos OLE.

AfxEnableControlContainer

Chame esta função na função do InitInstance seu objeto de aplicação para permitir o suporte de contenção de controlos OLE.

Sintaxe

void AfxEnableControlContainer( );

Observações

Para mais informações sobre controlos OLE (agora chamados controlos ActiveX), consulte Tópicos de Controlo ActiveX.

Requerimentos

Cabeçalho: afxdisp.h

AfxOleInit

Inicializa o suporte OLE para a aplicação.

BOOL AFXAPI AfxOleInit();

Valor de retorno

Não nulo se for bem-sucedido; 0 se a inicialização falhar, possivelmente porque versões incorretas das DLLs do sistema OLE estão instaladas.

Observações

Chame esta função para inicializar o suporte OLE para uma aplicação MFC. Quando esta função é chamada, ocorrem as seguintes ações:

  • Inicializa a biblioteca COM no apartamento atual da aplicação de chamada. Para mais informações, consulte OleInitialize.

  • Cria um objeto de filtro de mensagens, implementando a interface IMessageFilter . Este filtro de mensagens pode ser acedido através de uma chamada para AfxOleGetMessageFilter.

Observação

Se o AfxOleInit for chamado a partir de uma DLL MFC, a chamada falhará. A falha ocorre porque a função assume que, se for chamada a partir de uma DLL, o sistema OLE foi previamente inicializado pela aplicação que chama.

Observação

Os aplicativos MFC devem ser inicializados como apartamento de thread único (STA). Se você chamar CoInitializeEx em sua substituição de InitInstance, especifique COINIT_APARTMENTTHREADED (em vez de COINIT_MULTITHREADED).

Requerimentos

Cabeçalho: afxdisp.h

Consulte também

Macros e Globais