Erstellen von Beispielen
Um ein COM-Beispiel zu erstellen, muss die Computerumgebung für die Erstellung von Microsoft Win32 C++-Anwendungen eingerichtet sein.
Vorbereiten eines Computers zum Erstellen von COM-Beispielen
Die Computerumgebung muss mit einem ordnungsgemäß installierten 32-Bit-C++-Compiler, Linker und Ressourcencompiler eingerichtet werden, die mit Microsoft Visual C++ 4.x oder höher kompatibel sind, und einem ordnungsgemäß installierten Windows SDK. Es empfiehlt sich, das Windows SDK zuletzt zu installieren. Das Windows SDK stellt H-Include- und LIB-Bibliotheksdateien bereit, die für die in den Beispielen codierte COM-Funktionalität erforderlich sind.
Für die erfolgreiche Ausführung der Beispiele Remclien, Freserve und Freclien sind Systemeinrichtungen erforderlich, die in den Windows-Betriebssystemen windows Server 2003, Windows XP, Windows 2000 oder Windows NT 4.0 verfügbar sind. Die Remclien-, Freserve- und Freclien-Beispiele werden zwar erstellt, aber nicht unter den Betriebssystemen Windows Me, Windows 98 oder Windows 95 ausgeführt, es sei denn, Distributed COM (DCOM) und Com mit kostenlosem Thread sind Teil des Betriebssystems. Diese Unterstützung ist für die Betriebssysteme Windows Me, Windows 98 und Windows 95 im DCOM95-Add-On verfügbar.
Jedes Beispielverzeichnis verfügt über die erforderlichen Quelldateien zum Erstellen und Ausführen des Beispiels. Das übergeordnete Beispielverzeichnis verfügt über eine Makeall.bat Datei, die Sie über die Eingabeaufforderung ausführen können, um alle Codebeispiele im folgenden Branch zu erstellen. Weitere Informationen finden Sie in der datei Makeall.bat. Wenn Ihre Umgebung für die Erstellung von Win32 C++-Anwendungen eingerichtet ist, können Sie einfach Makeall.bat aus dem Verzeichnis ausführen, in dem sie sich befindet, um alle Codebeispiele im folgenden Branch zu erstellen. Makeall stellt die richtige Reihenfolge für den Build sicher, damit alle Codebeispielabhängigkeiten erfüllt werden.
Das Verzeichnis Standard enthält auch eine Makefile-Datei, die alle Tutorial-Codebeispiele mit Optionen erstellt, die denen ähneln, die von Makeall.bat unterstützt werden. Weitere Informationen finden Sie in dieser Makefile-Datei. Bei dieser Makefile-Datei wird davon ausgegangen, dass der gesamte Codebeispielbranch als Teil des Windows SDK installiert ist. Dieser Speicherort weist derzeit einen Pfad ähnlich wie D:\MSSDK\SAMPLES\COM\TUTSAMP auf, wobei D: das Installationslaufwerk darstellt. Wenn Sie den Tutorialcodebeispielbranch (z. B. das COM-Verzeichnis COM und die zugehörigen Unterverzeichnisse) an einen anderen Speicherort außerhalb des Windows SDK extrahiert haben (oder wenn Sie den Beispielsatz als separaten Download von der Microsoft-Website abgerufen haben), verwenden Sie Makeall.bat, um alle Beispiele im Branch zu kompilieren. Im Allgemeinen wird Makeall.bat empfohlen. Eine Logmall.bat-Datei wird ebenfalls bereitgestellt. Dies entspricht der Makeall-Batchdatei, mit der Ausnahme, dass die gesamte Kompilierungsausgabe in der Datei Errorlog.txt im Standard-Tutorialverzeichnis protokolliert wird.
Zwei Batchdateien, Regall.bat und Unregall.bat, werden auch im Verzeichnis Standard bereitgestellt, um alle COM-Server in der Tutorialcodebeispielreihe zu registrieren und aufzuheben. Um alle Server zu registrieren, führen Sie Regall.bat Datei aus dem Verzeichnis Standard aus. Um die Registrierung aller Server aufzuheben, führen Sie Unregall.bat auf die gleiche Weise aus. Diese Batchdateien erfordern einen vorherigen Build der Codebeispiele REGISTER, MARSHAL, DLLSERVE, LICSERVE, LOCSERVE, APTSERVE, FRESERVE und CONSERVE. Wenn Sie einen normalen Build der Codebeispiele ausführen, werden die Server automatisch von den Server-Makefiles registriert. In diesem Fall ist es nicht erforderlich, die Regall-Batchdatei auszuführen.
Führen Sie die Cleanall.bat Batchdatei aus, um eine vollständige Bereinigung aller COM-Tutorialbeispiele durchzuführen.
Warnung
Diese Batchdatei löscht alle Visual Studio-Projektdateien und andere temporäre Arbeitsdateien, die von Visual C++ in den Beispielen erstellt wurden. Alle com-Server, die in den Codebeispielen des Tutorials erstellt wurden, werden nicht in der Registrierung registriert. Alle ausführbaren exe- und .dll Dateien werden gelöscht. Alle Debugsymboldateien werden gelöscht. Dateien, die in einer Vielzahl von Buildumgebungen generiert werden, werden ebenfalls gelöscht.
Führen Sie "Makeall Clean" aus, um eine schnellere, aber bescheidenere Bereinigung aller Codebeispiele durchzuführen. Dieser Reinigungsvorgang versucht nicht, so umfassend zu sein, wie er von Cleanall.bat durchgeführt wird. Die OBJ-Dateien werden gelöscht, aber die Ausgabebinärdateien werden beibehalten. Die Registrierung der COM-Server in der Registrierung ist nicht aufgehoben.
Diese Beispielreihe ist als integraler Bestandteil des Windows SDK entstanden, daher geht die Tutorialerzählung von einer Umgebung aus, in der das Windows SDK ordnungsgemäß installiert ist.
Releases von Microsoft Visual C++ Version 4.0 und höher können jedoch auch die für die Kompilierung erforderlichen .h include- und .lib-Bibliotheksdateien bereitstellen. In solchen Fällen ist die Installation des Windows SDK möglicherweise nicht erforderlich, um die Beispiele zu kompilieren.
Weitere Informationen und vollständige Beispielbuilddetails finden Sie unter:
Konventionen für Codierungsstile