Jak zbudować próbki

Aby utworzyć przykład modelu COM, należy skonfigurować środowisko komputera w celu kompilowania aplikacji Microsoft Win32 C++.

Przygotowywanie komputera do tworzenia próbek COM

Środowisko komputera musi zostać skonfigurowane przy użyciu poprawnie zainstalowanego 32-bitowego kompilatora języka C++, konsolidatora i kompilatora zasobów, które są zgodne z programem Microsoft Visual C++ 4.x lub nowszym oraz prawidłowo zainstalowanym zestawem WINDOWS SDK. Najlepiej zainstalować zestaw Windows SDK ostatnio. Zestaw Windows SDK udostępnia pliki nagłówkowe .h i biblioteki .lib wymagane dla funkcji COM zapisanych w przykładach.

Aby pomyślnie uruchomić próbki Remclien, Freserve i Freclien, wymaga urządzeń systemowych dostępnych w systemach operacyjnych Windows: Windows Server 2003, Windows XP, Windows 2000 lub Windows NT 4.0. Próbki Remclien, Freserve i Freclien będą kompilowane, ale nie będą działać w systemach operacyjnych Windows Me, Windows 98 lub Windows 95, chyba że Distributed COM (DCOM) i Free Threaded COM są częścią systemu operacyjnego. Ta obsługa jest dostępna dla systemów operacyjnych Windows Me, Windows 98 i Windows 95 w dodatku DCOM95.

Każdy przykładowy katalog ma niezbędne pliki źródłowe do skompilowania i uruchomienia przykładu. Nadrzędny katalog przykładowy zawiera plik Makeall.bat, który można uruchomić z wiersza polecenia, aby wykonać wszystkie przykłady kodu w gałęzi poniżej. Aby uzyskać więcej informacji, zobacz plik Makeall.bat. Jeśli środowisko jest skonfigurowane do kompilowania aplikacji Win32 C++, możesz po prostu uruchomić Makeall.bat z katalogu, w którym znajduje się, aby skompilować wszystkie przykłady kodu w gałęzi poniżej. Makeall zapewnia poprawną kolejność kompilacji, tak aby wszystkie zależności przykładowe kodu zostały spełnione.

Katalog główny zawiera również plik make, który kompiluje wszystkie przykłady kodu samouczka przy użyciu opcji podobnych do tych obsługiwanych przez Makeall.bat. Aby uzyskać więcej informacji, zobacz ten makefile. W tym pliku makefile przyjęto założenie, że cała gałąź przykładów kodu jest zainstalowana jako część zestawu Windows SDK. Obecnie ta lokalizacja ma ścieżkę podobną do D:\MSSDK\SAMPLES\COM\TUTSAMP, gdzie D: reprezentuje dysk instalacyjny. Jeśli wyodrębniono gałąź przykładową kodu samouczka (na przykład katalog COM i jego podkatalogi) do innej lokalizacji poza zestawem Windows SDK (lub jeśli pobrano przykładowy zestaw jako oddzielny plik do pobrania z witryny internetowej firmy Microsoft), użyj Makeall.bat, aby skompilować wszystkie przykłady w gałęzi. Ogólnie rzecz biorąc, zaleca się Makeall.bat. Dostępny jest również plik Logmall.bat. Robi to samo co plik wsadowy Makeall, z tą różnicą, że rejestruje wszystkie dane wyjściowe kompilacji w pliku Errorlog.txt w głównym katalogu samouczka.

Dwa pliki wsadowe, Regall.bat i Unregall.bat, są również udostępniane w katalogu głównym w celu zarejestrowania i wyrejestrowania wszystkich serwerów COM w przykładowej serii kodu samouczka. Aby zarejestrować wszystkie serwery, uruchom plik Regall.bat z katalogu głównego. Aby wyrejestrować wszystkie serwery, uruchom Unregall.bat w ten sam sposób. Te pliki wsadowe wymagają wcześniejszej kompilacji przykładów kodu REGISTER, MARSHAL, DLLSERVE, LICSERVE, LOCSERVE, APTSERVE, FRESERVE i CONSERVE. Jeśli wykonasz normalną kompilację przykładów kodu, pliki makefile serwera będą automatycznie rejestrować serwery. W takim przypadku nie jest konieczne uruchomienie pliku wsadowego Regall.

Uruchom plik wsadowy Cleanall.bat, aby wykonać skończone czyszczenie wszystkich przykładów z samouczka COM.

Uruchom polecenie "Makeall Clean", aby wykonać szybsze, ale skromniejsze czyszczenie wszystkich przykładów kodu. Ta operacja czyszczenia nie próbuje być tak kompleksowa, jak ta wykonywana przez Cleanall.bat. Pliki .obj są usuwane, ale pliki binarne wyjściowe są zachowywane. Serwery COM nie są wyrejestrowane z rejestru.

Ta przykładowa seria powstała jako integralna część zestawu Windows SDK, dlatego w scenariuszu samouczka przyjęto założenie, że środowisko z zestawem Windows SDK jest prawidłowo zainstalowane.

Jednak wersje programu Microsoft Visual C++ od wersji 4.0 mogą również udostępniać pliki nagłówkowe .h i biblioteki .lib wymagane do kompilacji. W takich przypadkach instalacja zestawu Windows SDK może nie być wymagana do skompilowania przykładów.

Aby uzyskać więcej informacji i pełne przykładowe szczegóły kompilacji, zobacz:

Konfiguracja środowiska

plików programu Make

przy użyciu programu Visual Studio

Wyodrębnianie Przykładów Kodu

konwencje stylu kodowania