登録

[アーティクル]
06/16/2023

ユーザーが OLE 項目をアプリケーションに挿入する場合、OLE は選択できるオブジェクトの種類の一覧を提示します。 OLE はシステム登録データベースからこの一覧を取得します。このデータベースには、すべてのサーバーアプリケーションによって提供された情報が含まれています。サーバー自体が登録される場合、システム登録データベース (レジストリ) に格納されるエントリによって、提供される各オブジェクトの種類、ファイル拡張子、サーバー自体へのパスなどの情報が記述されます。

フレームワークと OLE システムのダイナミックリンクライブラリ (DLL) は、このレジストリを使用して、どの OLE 項目の種類をシステムで使用できるかを判別します。また、OLE システム DLL はこのレジストリを使用して、リンクされるか埋め込まれたオブジェクトがアクティブ化されたときにサーバーアプリケーションを起動する方法も決定します。

この記事では、各サーバーアプリケーションが、インストール時と各実行時に何をする必要があるかについて説明します。

システム登録データベースの詳細と、それを更新するために使用する .reg ファイルの形式については、「OLE プログラマリファレンス」を参照してください。

サーバーのインストール

初めてサーバーアプリケーションをインストールする場合は、サポートするすべての種類の OLE 項目を登録する必要があります。また、サーバーがスタンドアロンアプリケーションとして実行されるたびに、サーバーによってシステム登録データベースが更新されるようにすることもできます。そうすることで、サーバーの実行可能ファイルが移動された場合にも、登録データベースが最新の状態に保たれます。

Note

アプリケーションウィザードによって生成された MFC アプリケーションは、スタンドアロンアプリケーションとして実行されるときに、自動的にアプリケーション自体を登録します。

インストール中にアプリケーションを登録する場合は、RegEdit.exe プログラムを使用します。アプリケーションにセットアッププログラムを含める場合は、セットアッププログラムで "RegEdit /S appname.reg" を実行してください。 (/S フラグはサイレント操作を示します。つまり、コマンドが正常に完了したことを示すダイアログボックスは表示されません)。それ以外の場合は、RegEdit を手動で実行するようにユーザーに指示します。

Note

アプリケーションウィザードによって作成された .reg ファイルには、実行可能ファイルの完全なパスが含まれていません。インストールプログラムでは、実行可能ファイルへの完全なパスを含むように .reg ファイルを変更するか、インストールディレクトリを含めるように PATH 環境変数を変更する必要があります。

RegEdit によって、.reg テキストファイルの内容が登録データベースにマージされます。データベースを確認または修復するには、レジストリエディターを使用します。必須の OLE エントリを削除しないように注意してください。

サーバーの初期化

アプリケーションウィザードを使用してサーバーアプリケーションを作成すると、ウィザードによってすべての初期化タスクが自動的に完了されます。このセクションでは、サーバーアプリケーションを手動で記述する場合に必要な操作について説明します。

サーバーアプリケーションがコンテナーアプリケーションによって起動されると、OLE システム DLL によって、サーバーのコマンドラインに "/Embedding" オプションが追加されます。サーバーアプリケーションの動作は、コンテナーによって起動されたかどうかによって異なります。そのため、アプリケーションが実行の開始時に最初に行う必要があるのは、コマンドラインの "/Embedding" または "-Embedding" オプションを確認することです。このスイッチが存在する場合は、サーバーをインプレースアクティブまたは完全なオープンの状態で表示する、別のリソースのセットを読み込みます。詳細については、「メニューとリソース: サーバーの変更点」を参照してください。

また、サーバーアプリケーションは、コマンドラインを解析するために、その CWinApp::RunEmbedded 関数を呼び出す必要もあります。 0 以外の値が返される場合、アプリケーションはウィンドウを表示してはいけません。スタンドアロンアプリケーションとしてではなく、コンテナーアプリケーションから実行されているためです。この関数は、システム登録データベース内のサーバーのエントリを更新し、RegisterAll メンバー関数を呼び出してインスタンスの登録を行います。

サーバーアプリケーションを起動するときに、アプリケーションがインスタンスの登録を実行できることを確認する必要があります。インスタンス登録によって、サーバーがアクティブであることと、コンテナーから要求を受信する準備ができていることが、OLE システム DLL に通知されます。これによって、登録データベースにエントリが追加されることはありません。 COleTemplateServer によって定義された ConnectTemplate メンバー関数を呼び出すことによって、サーバーのインスタンス登録を実行します。これにより、CDocTemplate オブジェクトが COleTemplateServer オブジェクトに接続されます。

ConnectTemplate 関数は、3 つのパラメーター (サーバーの CLSID、CDocTemplate オブジェクトへのポインター、およびサーバーで複数のインスタンスがサポートされているかどうかを示すフラグ) を受け取ります。ミニサーバーは、複数のインスタンスをサポートできる必要があります。つまり、サーバーの複数のインスタンス (コンテナーごとに 1 つ) を同時に実行できる必要があります。そのため、ミニサーバーを起動するとき、このフラグに TRUE を渡します。

ミニサーバーを記述している場合は、定義上、ミニサーバーは常にコンテナーによって起動されます。この場合もコマンドラインを解析して、"/Embedding" オプションを確認する必要があります。コマンドラインにこのオプションがない場合は、ユーザーがスタンドアロンアプリケーションとしてミニサーバーを起動しようとしたことになります。そうなった場合は、システム登録データベースにサーバーを登録し、コンテナーアプリケーションからミニサーバーを起動するようにユーザーに指示するメッセージボックスを表示します。

次の方法で共有

登録

サーバーのインストール

サーバーの初期化

関連項目

フィードバック

その他のリソース