Como criar exemplos
Para criar um exemplo COM, o ambiente do computador deve ser configurado para criar aplicativos Microsoft Win32 C++.
Preparando um computador para criar exemplos COM
O ambiente do computador deve ser configurado com um compilador, vinculador e compilador de recursos C++ de 32 bits instalado corretamente que seja compatível com Microsoft Visual C++ 4.x ou posterior e um SDK do Windows instalado corretamente. É melhor instalar o SDK do Windows por último. O SDK do Windows fornece arquivos de biblioteca .h include e .lib necessários para a funcionalidade COM codificada nos exemplos.
Para executar com êxito os exemplos remclien, Freserve e Freclien exigem instalações do sistema disponíveis nos sistemas operacionais Windows: Windows Server 2003, Windows XP, Windows 2000 ou Windows NT 4.0. Os exemplos Remclien, Freserve e Freclien serão compilados, mas não serão executados nos sistemas operacionais Windows Me, Windows 98 ou Windows 95, a menos que o COM distribuído (DCOM) e o COM sem thread sejam parte do sistema operacional. Esse suporte está disponível para os sistemas operacionais Windows Me, Windows 98 e Windows 95 no complemento DCOM95.
Cada diretório de exemplo tem os arquivos de origem necessários para compilar e executar o exemplo. O diretório de exemplo pai tem um arquivo Makeall.bat, que você pode executar no prompt de comando para fazer todos os exemplos de código no branch abaixo. Para obter mais informações, consulte o arquivo Makeall.bat. Se o ambiente estiver configurado para criar aplicativos Win32 C++, você poderá simplesmente executar Makeall.bat no diretório em que ele reside para criar todos os exemplos de código no branch abaixo. Makeall garante a ordem correta para o build para que todas as dependências de exemplo de código sejam atendidas.
O diretório main também tem um makefile que cria todos os exemplos de código do tutorial usando opções semelhantes às compatíveis com Makeall.bat. Para obter mais informações, consulte este makefile. Esse makefile pressupõe que todo o branch de exemplos de código esteja instalado como parte do SDK do Windows. Atualmente, esse local tem um caminho semelhante a D:\MSSDK\SAMPLES\COM\TUTSAMP, em que D: representa a unidade de instalação. Se você tiver extraído o branch de exemplo de código do tutorial (por exemplo, o diretório COM e seus subdiretórios) para outro local fora do SDK do Windows (ou se você obteve o conjunto de exemplos como um download separado do site da Microsoft), use Makeall.bat para compilar todos os exemplos no branch. Em geral, é recomendável Makeall.bat. Um arquivo Logmall.bat também é fornecido. Ele faz o mesmo que o arquivo em lote Makeall, exceto pelo fato de registrar todas as saídas de compilação no Errorlog.txt de arquivo no diretório do tutorial main.
Dois arquivos em lote, Regall.bat e Unregall.bat, também são fornecidos no diretório main para registrar e cancelar o registro de todos os servidores COM na série de exemplo de código do tutorial. Para registrar todos os servidores, execute Regall.bat arquivo no diretório main. Para cancelar o registro de todos os servidores, execute Unregall.bat da mesma maneira. Esses arquivos em lote exigem um build anterior dos exemplos de código REGISTER, MARSHAL, DLLSERVE, LICSERVE, LOCSERVE, APTSERVE, FRESERVE e CONSERVE. Se você executar um build normal dos exemplos de código, os makefiles do servidor registrarão automaticamente os servidores. Nesse caso, não é necessário executar o arquivo em lote Regall.
Execute o arquivo em lote Cleanall.bat para executar um Cleanall exaustivo de todos os Exemplos de Tutorial COM.
Aviso
Esse arquivo em lote exclui todos os arquivos de projeto do Visual Studio e outros arquivos de trabalho temporários criados pelo Visual C++ nos exemplos. Todos os servidores COM criados nos exemplos de código do tutorial não são registrados no registro. Todos os arquivos exe e .dll executáveis são excluídos. Todos os arquivos de símbolo de depuração são excluídos. Os arquivos gerados em uma variedade de ambientes de build também são excluídos.
Execute 'Makeall Clean' para executar uma limpeza mais rápida, mas mais modesta, de todos os exemplos de código. Esta operação de limpeza não tenta ser tão abrangente quanto a executada por Cleanall.bat. Os arquivos .obj são excluídos, mas os binários de saída são mantidos. Os servidores COM não são cancelados do registro.
Esta série de exemplo se originou como parte integrante do SDK do Windows, portanto, a narrativa do tutorial pressupõe um ambiente com o SDK do Windows instalado corretamente.
No entanto, versões do Microsoft Visual C++ versão 4.0 e posterior também podem fornecer os arquivos de biblioteca .h include e .lib necessários para compilação. Nesses casos, a instalação do SDK do Windows pode não ser necessária para compilar os exemplos.
Para obter mais informações e concluir detalhes de build de exemplo, consulte:
Extraindo os exemplos de código
Convenções de estilo de codificação