Erstellen von Beispielen

Zum Erstellen eines COM-Beispiels muss die Computerumgebung so eingerichtet werden, dass Microsoft Win32 C++-Anwendungen erstellt werden.

Vorbereiten eines Computers zum Erstellen von COM-Beispielen

Die Computerumgebung muss mit einem ordnungsgemäß installierten 32-Bit-C++-Compiler, Linker und Ressourcencompiler eingerichtet werden, der mit Microsoft Visual C++ 4.x oder höher kompatibel ist, und einem ordnungsgemäß installierten Windows SDK. Es ist am besten, 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.

Zum erfolgreichen Ausführen der Remclien-, Freserve- und Freclien-Beispiele sind Systemanlagen erforderlich, die in den Windows Betriebssystemen verfügbar sind: Windows Server 2003, Windows XP, Windows 2000 oder Windows NT 4.0. Die Remclien-, Freserve- und Freclien-Beispiele werden erstellt, aber nicht auf den Windows Me-, Windows 98- oder Windows 95-Betriebssystemen ausgeführt, es sei denn, Distributed COM (DCOM) und free threaded COM 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 in der folgenden Verzweigung 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 in der folgenden Verzweigung zu erstellen. Makeall stellt die richtige Reihenfolge für den Build sicher, sodass alle Codebeispielabhängigkeiten erfüllt werden.

Das Hauptverzeichnis verfügt auch über ein Makefile, das alle Tutorialcodebeispiele mithilfe von Optionen erstellt, die denen ähneln, die von Makeall.bat unterstützt werden. Weitere Informationen finden Sie in diesem Makefile. Bei diesem Makefile wird davon ausgegangen, dass der gesamte Codebeispiel-Branch als Teil des Windows SDK installiert ist. Derzeit weist dieser Speicherort einen Pfad ähnlich D: \ MSSDK \ SAMPLES COM \ \ TUTSAMP auf, wobei D: das Installationslaufwerk darstellt. Wenn Sie den Tutorial-Codebeispiel-Branch (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 erhalten haben), verwenden Sie Makeall.bat, um alle Beispiele im Branch zu kompilieren. Im Allgemeinen wird Makeall.bat empfohlen. Es wird auch eine Logmall.bat-Datei bereitgestellt. Dies entspricht der Batchdatei Makeall, mit der Ausnahme, dass die gesamte Kompilierungsausgabe in der Datei protokolliert wird, die im Hauptverzeichnis des Tutorials Errorlog.txt.

Zwei Batchdateien, Regall.bat und Unregall.bat, werden ebenfalls im Hauptverzeichnis bereitgestellt, um alle COM-Server in der Codebeispielreihe des Tutorials zu registrieren und deren Registrierung zu aufheben. Führen Sie Regall.bat Datei aus dem Hauptverzeichnis aus, um alle Server zu registrieren. Führen Sie Unregall.bat auf die gleiche Weise aus, um die Registrierung aller Server zu aufheben. 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 Batchdatei "Regall" auszuführen.

Führen Sie die Cleanall.bat Batchdatei aus, um alle COM-Tutorialbeispiele vollständig zu bereinigen.

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 bei der Registrierung nicht 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 eher geringfügige Bereinigung aller Codebeispiele durchzuführen. Dieser Bereinigungsvorgang versucht nicht so umfassend wie der von Cleanall.bat ausgeführte. Die OBJ-Dateien werden gelöscht, aber die Ausgabebinärdateien werden beibehalten. Die Registrierung der COM-Server bei der Registrierung wird nicht aufgehoben.

Diese Beispielreihe stammt als integraler Bestandteil des Windows SDK. 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 .h include- und LIB-Bibliotheksdateien bereitstellen, die für die Kompilierung erforderlich sind. 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:

Umgebungseinrichtung

Makefiles

Verwenden von Visual Studio

Extrahieren der Codebeispiele

Konventionen für Codierungsstile