サンプルをビルドする方法
COM サンプルをビルドするには、Microsoft Win32 C++ アプリケーションをビルドするようにコンピューター環境を設定する必要があります。
COM サンプルを作成するためのコンピューターの準備
コンピューター環境は、Microsoft Visual C++ 4.x 以降と互換性のある適切にインストールされた 32 ビット C++ コンパイラ、リンカー、およびリソース コンパイラ、および適切にインストールされた Windows SDK を使用して設定する必要があります。 Windows SDK を最後にインストールすることをお勧めします。 Windows SDK には、サンプルでコード化された COM 機能に必要な .h インクルード ファイルと .lib ライブラリ ファイルが用意されています。
Remclien、Freserve、Freclien のサンプルを正常に実行するには、Windows オペレーティング システムで使用できるシステム機能 (Windows Server 2003、Windows XP、Windows 2000、または Windows NT 4.0) が必要です。 Remclien、Freserve、Freclien のサンプルはビルドされますが、分散 COM (DCOM) とフリー スレッド COM がオペレーティング システムの一部でない限り、Windows Me、Windows 98、または Windows 95 オペレーティング システムでは実行されません。 このサポートは、DCOM95 アドオンの Windows Me、Windows 98、および Windows 95 オペレーティング システムで使用できます。
各サンプル ディレクトリには、サンプルをビルドして実行するために必要なソース ファイルがあります。 親サンプル ディレクトリには Makeall.bat ファイルがあり、コマンド プロンプトからを実行して、以下のブランチ内のすべてのコード サンプルを作成できます。 詳細については、Makeall.bat ファイルを参照してください。 Win32 C++ アプリケーションをビルドするように環境が設定されている場合は、そのアプリケーションが存在するディレクトリからMakeall.batを実行するだけで、以下のブランチですべてのコード サンプルをビルドできます。 Makeall は、すべてのコード サンプルの依存関係が満たされるように、ビルドの正しい順序を保証します。
メイン ディレクトリには、Makeall.batでサポートされているものと同様のオプションを使用して、すべてのチュートリアル コード サンプルをビルドするメイクファイルもあります。 詳細については、このメイクファイルを参照してください。 このメイクファイルは、コード サンプル ブランチ全体が Windows SDK の一部としてインストールされていることを前提としています。 現在、この場所には D:\MSSDK\SAMPLES\COM\TUTSAMP のようなパスがあります。D: はインストール ドライブを表します。 チュートリアル コード サンプル ブランチ (COM ディレクトリ COM とそのサブディレクトリなど) を Windows SDK の外部の別の場所に抽出した場合 (または Microsoft Web サイトから別のダウンロードとしてサンプル セットを取得した場合)、Makeall.batを使用してブランチ内のすべてのサンプルをコンパイルします。 一般に、Makeall.batをお勧めします。 Logmall.bat ファイルも提供されます。 Makeall バッチ ファイルと同じですが、すべてのコンパイル出力を メイン チュートリアル ディレクトリのファイル Errorlog.txtに記録します。
Regall.batとUnregall.batの 2 つのバッチ ファイルも メイン ディレクトリに用意されており、チュートリアル コード サンプル シリーズのすべての COM サーバーを登録および登録解除します。 すべてのサーバーを登録するには、メイン ディレクトリから Regall.bat ファイルを実行します。 すべてのサーバーの登録を解除するには、同じ方法でUnregall.batを実行します。 これらのバッチ ファイルには、REGISTER、MARSHAL、DLLSERVE、LICSERVE、LOCSERVE、APTSERVE、FRESERVE、および CONSERVE コード サンプルの事前ビルドが必要です。 コード サンプルの通常のビルドを実行すると、サーバー メイクファイルによってサーバーが自動的に登録されます。 この場合、Regall バッチ ファイルを実行する必要はありません。
Cleanall.batバッチ ファイルを実行して、すべての COM チュートリアル サンプルの完全な Cleanall を実行します。
警告
このバッチ ファイルは、サンプル内の Visual C++ によって作成されたすべての Visual Studio プロジェクト ファイルとその他の一時作業ファイルを削除します。 チュートリアル コード サンプルに組み込まれている COM サーバーはすべて、レジストリから登録解除されます。 実行可能な exe ファイルと.dll ファイルはすべて削除されます。 すべてのデバッグ シンボル ファイルが削除されます。 さまざまなビルド環境で生成されたファイルも削除されます。
"Makeall Clean" を実行して、すべてのコード サンプルのより高速で、より控えめなクリーンアップを実行します。 このクリーニング操作は、Cleanall.batによって実行されるのと同じくらい包括的な操作を試みません。 .obj ファイルは削除されますが、出力バイナリは保持されます。 COM サーバーはレジストリから登録解除されません。
このサンプル シリーズは Windows SDK の不可欠な部分として作成されているため、チュートリアルの説明では、Windows SDK が適切にインストールされた環境を前提としています。
ただし、Microsoft Visual C++ バージョン 4.0 以降のリリースでは、コンパイルに必要な .h インクルード および .lib ライブラリ ファイルも提供される場合があります。 このような場合、サンプルをコンパイルするために Windows SDK のインストールが必要ない場合があります。
詳細と完全なサンプル ビルドの詳細については、次を参照してください。