Создание примеров
Чтобы создать пример COM, необходимо настроить компьютерную среду для создания приложений Microsoft Win32 C++.
Подготовка компьютера к созданию примеров COM
Компьютерная среда должна быть настроена с правильно установленным 32-разрядным компилятором C++, компоновщиком и компилятором ресурсов, совместимыми с Microsoft Visual C++ 4.x или более поздней версии, а также надлежащим образом установленным windows SDK. Рекомендуется установить пакет Windows SDK последним. Пакет SDK для Windows предоставляет файлы библиотек .h include и .lib, необходимые для функций COM, закодированных в примерах.
Для успешного запуска примеров Remclien, Freserve и Freclien требуются системные средства, доступные в операционных системах Windows: Windows Server 2003, Windows XP, Windows 2000 или Windows NT 4.0. Примеры Remclien, Freserve и Freclien будут создаваться, но не будут работать в операционных системах Windows Me, Windows 98 или Windows 95, если только в состав операционной системы не входят распределенные COM (DCOM) и бесплатные потоки COM. Эта поддержка доступна для операционных систем Windows Me, Windows 98 и Windows 95 в добавлении DCOM95.
Каждый каталог с примерами содержит необходимые исходные файлы для сборки и запуска примера. Родительский каталог с примерами содержит Makeall.bat файл, который можно запустить из командной строки, чтобы создать все примеры кода в ветви ниже. Дополнительные сведения см. в файле Makeall.bat. Если ваша среда настроена для создания приложений Win32 C++, можно просто запустить Makeall.bat из каталога, в котором она находится, чтобы собрать все примеры кода в приведенной ниже ветви. Makeall обеспечивает правильный порядок сборки, чтобы все зависимости образца кода были удовлетворены.
Каталог main также содержит файл makefile, который создает все примеры кода учебника с помощью параметров, аналогичных поддерживаемым Makeall.bat. Дополнительные сведения см. в этом файле makefile. В этом файле makefile предполагается, что вся ветвь примеров кода установлена как часть windows SDK. В настоящее время это расположение имеет путь, аналогичный D:\MSSDK\SAMPLES\COM\TUTSAMP, где D: представляет диск установки. Если вы извлекли ветвь примера кода учебника (например, COM-каталог COM и его подкаталоги) в другое расположение за пределами пакета SDK для Windows (или если вы получили набор примеров для отдельной загрузки с веб-сайта Майкрософт), используйте Makeall.bat для компиляции всех примеров в ветви. Как правило, рекомендуется Makeall.bat. Также предоставляется файл Logmall.bat. Он выполняет то же самое, что и пакетный файл Makeall, за исключением того, что все выходные данные компиляции записываются в файл Errorlog.txt в каталоге учебника по main.
Два пакетных файла, Regall.bat и Unregall.bat, также предоставляются в каталоге main для регистрации и отмены регистрации всех COM-серверов в серии примеров кода руководства. Чтобы зарегистрировать все серверы, запустите Regall.bat файл из каталога main. Чтобы отменить регистрацию всех серверов, выполните Unregall.bat таким же образом. Для этих пакетных файлов требуется предварительная сборка примеров кода REGISTER, MARSHAL, DLLSERVE, LICSERVE, LOCSERVE, APTSERVE, FRESERVE и CONSERVE. Если вы выполняете обычную сборку примеров кода, сервер makefiles будет автоматически регистрировать серверы. В этом случае нет необходимости запускать пакетный файл Regall.
Запустите пакетный файл Cleanall.bat, чтобы выполнить исчерпывающую очистку всех примеров руководства по COM.
Предупреждение
Этот пакетный файл удаляет все файлы проекта Visual Studio и другие временные рабочие файлы, созданные Visual C++ в примерах. Все COM-серверы, встроенные в примерах кода учебника, не регистрируются в реестре. Удаляются все исполняемые файлы EXE и .dll. Все файлы отладочных символов удаляются. Файлы, созданные в различных средах сборки, также удаляются.
Выполните команду Makeall Clean, чтобы выполнить более быструю, но более скромную очистку всех примеров кода. Эта операция очистки не является такой же комплексной, как операция, выполняемая Cleanall.bat. OBJ-файлы удаляются, но выходные двоичные файлы сохраняются. Com-серверы не отменяются регистрации в реестре.
Этот пример серии был создан как неотъемлемая часть пакета Windows SDK, поэтому в описании учебника предполагается, что среда с пакетом WINDOWS SDK установлена правильно.
Однако выпуски Microsoft Visual C++ версии 4.0 и более поздних версий также могут предоставлять файлы библиотек .h include и LIB, необходимые для компиляции. В таких случаях установка пакета Windows SDK может не потребоваться для компиляции примеров.
Дополнительные сведения и полные сведения о сборке см. в разделе:
Соглашения о стиле программирования