StoClien の概要
目的
StoClien サンプルの主な焦点は、クライアントが構造化ストレージを使用する方法と、このストレージを使用するようにサーバー コンポーネントに指示する方法です。 StoClien サンプルは、構造化ストレージ サービスのプログラミング モデルを示しています。
機能
StoClien 機能は、一部のバージョンのMicrosoft Visual C++の "落書き" サンプルに似ています。 StoClien サンプルと StoServe サンプルの違いは、COM テクノロジに基づく内部アーキテクチャです。 COM クライアントと COM サーバーの間では、明確なアーキテクチャの違いが維持されます。
StoClien は、COM 複合ファイルの構造化ストレージに図面を読み込んで保存します。
StoClien サンプルでは、StoServe サーバーのCLSID_DllPaper コンポーネントとして提供される接続可能な COPaper COM オブジェクトを作成して使用します。 StoClien クライアントは、COPaper オブジェクトを作成し、オブジェクトが公開する IPaper インターフェイスを介して制御します。 StoClien は、ユーザーから描画データを取得し、管理するウィンドウでグラフィカルに表します。 StoClien は、COPaper IPaper インターフェイスを使用して、描画データを COPaper に保存し、このデータに対するファイルストレージ操作を指示します。
COPaper COM オブジェクトは、図面用紙データのサーバー ベースのストレージのみをカプセル化します。サーバー側ではグラフィカル ユーザー インターフェイス (GUI) 動作は提供されません。 すべての GUI 動作は、クライアントで分離されます。 COPaper オブジェクトのデータ管理およびストレージ機能は、COM カスタム インターフェイス IPaper を介してのみ使用できます。
StoClien は COPaper と協力して、COPaper 描画データを読み込んで保存します。 StoClien は、複合ファイル内のストレージ オブジェクトの IStorage インターフェイスを取得します。 読み込みと保存の操作で、StoClien は IStorage インターフェイスへのポインターをサーバーの COPaper に渡します。 COPaper は、提供された IStorage を使用してストレージにストリームを作成します。 COPaper は、標準の IStream インターフェイスを使用して、管理する描画データの読み取りと書き込みを行うことができます。
COPaper は図面データのみを管理します。GUI アクションは実行されません。 StoClien は、描画アプリケーションの GUI を提供します。 これは、中央の CGuiPaper C++ オブジェクトにカプセル化されます。
StoClien は、COPaperSink COM オブジェクトにカスタム IPaperSink インターフェイスも実装し、このインターフェイスをサーバー COPaper オブジェクト内の適切な接続ポイントに接続します。 COPaper は、接続された IPaperSink インターフェイスを使用して、StoClien に通知を送信します。 COPaper 描画データの通常の GUI 再描画は、COPaper 接続可能なオブジェクト テクノロジを使用して StoClien で行われます。
StoClien は、通常の方法で、またはコマンド プロンプト ウィンドウから直接実行できるアプリケーションです。 StoClien は、コマンド ラインでオプションのファイル名パラメーターを受け入れます。
次の例では、Drawing.pap は、DllPaper 互換の図面データの構造化ストレージを含む複合ファイルです。 コマンド ライン ファイル名パラメーターが指定されていない場合、 StoClien は既定のファイル名 Stoclien.pap を使用し、実行中のStoclien.exeと同じディレクトリで開こうとします。
StoClien c:\drawing\drawing.pap
サポート情報
StoClien の詳細、機能の説明、およびコード チュートリアルについては、Stoclien.htmのコード ツアーに関するセクションを参照してください。 StoClien の外部ユーザー操作の詳細については、Stoclien.htmの「使用法と操作」セクションを参照してください。 Stoclient.htmを読むには、メイン チュートリアル ディレクトリでTutorial.exeを実行し、レッスンの表にある StoClien レッスンをクリックします。 または、Windows エクスプローラーでメインチュートリアル ディレクトリを見つけた後、[Stoclien.htm] をクリックします。 StoServe がどのように機能し、そのサービスを StoClien に公開するかの詳細については、メイン チュートリアル ディレクトリのStoserve.htmを参照してください。 StoClien をビルドする前に、Stoserve.dllをビルドする必要があることに注意してください。 StoServe のメイクファイルは、そのサーバーをシステム レジストリに登録するため、StoClien を実行する前に StoServe をビルドする必要があります。
この COM チュートリアル シリーズのコード サンプルをビルドしてテストするためのシステムの設定の詳細については、「 サンプルをビルドする方法」を参照してください。 指定されたメイクファイル (MAKEFILE) は Microsoft NMAKE 互換です。 デバッグ ビルドを作成するには、コマンド プロンプト ウィンドウで NMAKE コマンドを発行します。
便宜上、Microsoft Visual Studio で使用するサンプルごとにプロジェクト ファイルが用意されています。 StoClien サンプルのプロジェクトを読み込むには、次のようにサンプル ディレクトリのコマンド プロンプトで Visual Studio を実行します。
MSDEV STOCLIEN。Dsp
Windows エクスプローラーで Stoclient.dsp ファイルをダブルクリックして、サンプル プロジェクトを Visual Studio に読み込むこともできます。 Visual Studio では、サンプル ソースの C++ クラスを参照し、通常は他の編集/コンパイル/デバッグ操作を実行できます。 サーバー SDK の一部として、Visual Studio 内からこれらのサンプルをコンパイルするには、Visual Studio でディレクトリ パスを適切に設定する必要があることに注意してください。 詳細については、「 サンプルをビルドする方法」を参照してください。
解説
クライアントを実行するには、クライアント サンプルとその他の関連サンプルをコンパイルする必要があります。 サンプルのビルドの詳細については、「サンプルを ビルドする方法」を参照してください。 適切なサンプルをビルドした場合は、このサンプルで実行するクライアント実行可能ファイルStoclien.exe。
Stoclien.exe アプリケーションは、このチュートリアルのユーザー インターフェイスを提供します。 複合ファイル内の COM 構造化ストレージのクライアントとサーバーの両方の使用を示すために、関連付けられているが独立したStoserve.dllを実行します。