StoClien Übersicht

Zweck

Der Hauptfokus des StoClien-Beispiels liegt darin, wie der Client strukturierten Speicher verwendet und wie er eine Serverkomponente anweist, diesen Speicher zu verwenden. Das StoClien-Beispiel veranschaulicht ein Programmiermodell strukturierter Speicherdienste.

Funktionalität

Die StoClien-Funktionalität ähnelt den "Scribble"-Beispielen in einigen Versionen von Microsoft Visual C++. Der Unterschied zwischen dem StoClien-Beispiel und dem StoServe-Beispiel ist eine interne Architektur, die auf COM-Technologie basiert. Eine klare architektonische Unterscheidung wird zwischen COM-Client und COM-Server beibehalten.

StoClien lädt und speichert seine Zeichnungen in der strukturierten Speicherung von COM-Verbunddateien.

Das StoClien-Beispiel erstellt und verwendet das verbindungsfähige COPaper COM-Objekt, das als CLSID_DllPaper Komponente auf dem StoServe-Server bereitgestellt wird. Der StoClien-Client erstellt ein COPaper-Objekt und steuert es über die IPaper-Schnittstelle, die das Objekt verfügbar macht. StoClien ruft Zeichnungsdaten vom Benutzer ab und stellt sie in einem von ihm verwalteten Fenster grafisch dar. StoClien verwendet die COPaper IPaper-Schnittstelle, um die Zeichnungsdaten in COPaper zu speichern und Dateispeichervorgänge auf diese Daten zu leiten.

Ein COPaper COM-Objekt kapselt nur den serverbasierten Speicher der Zeichnungspapierdaten: Auf serverseitiger Seite wird kein grafisches Benutzeroberflächenverhalten (GUI) bereitgestellt. Das gesamte GUI-Verhalten ist im Client isoliert. Die Datenverwaltungs- und Speicherfunktionen von COPaper-Objekten sind nur über eine benutzerdefinierte COM-Schnittstelle, IPaper, verfügbar.

StoClien arbeitet mit dem COPaper zusammen, um die COPaper-Zeichnungsdaten zu laden und zu speichern. StoClien ruft eine IStorage-Schnittstelle für das Speicherobjekt in einer Verbunddatei ab. In seinen Lade- und Speichervorgängen übergibt StoClien einen Zeiger an die IStorage-Schnittstelle an COPaper auf dem Server. COPaper verwendet das bereitgestellte IStorage zum Erstellen von Datenströmen im Speicher. COPaper kann dann die standardmäßige IStream-Schnittstelle zum Lesen und Schreiben der von ihm verwalteten Zeichnungsdaten verwenden.

COPaper verwaltet nur die Zeichnungsdaten; es führt keine GUI-Aktionen aus. StoClien stellt die GUI für die Zeichnungsanwendung bereit. Sie kapselt dies in einem zentralen CGuiPaper C++-Objekt.

StoClien implementiert auch die benutzerdefinierte IPaperSink-Schnittstelle in einem COPaperSink COM-Objekt und verbindet diese Schnittstelle mit einem geeigneten Verbindungspunkt im COPaper-Objekt des Servers. COPaper verwendet die verbundene IPaperSink-Schnittstelle, um Benachrichtigungen zurück an StoClien zu senden. Die normale GUI-Aktualisierung der Zeichnungsdaten von COPaper erfolgt in StoClien mit der COPaper connectable Objekttechnologie.

StoClien ist eine Anwendung, die Sie direkt auf normale Weise oder über das Eingabeaufforderungsfenster ausführen können. StoClien akzeptiert einen optionalen Dateinamenparameter in der Befehlszeile.

Im folgenden Beispiel ist Drawing.pap eine Verbunddatei, die dllPaper-kompatible strukturierte Speicherung von Zeichnungsdaten enthält. Wenn kein Befehlszeilendateiname-Parameter angegeben ist, verwendet StoClien den Standarddateinamen Stoclien.pap und versucht, ihn im selben Verzeichnis wie die ausgeführte Stoclien.exezu öffnen.

StoClien c:\drawings\drawing.pap

Supportinformationen

Weitere Informationen, funktionale Beschreibungen und ein Code-Lernprogramm für StoClien finden Sie im Abschnitt "Code Tour" in Stoclien.htm. Weitere Informationen zum externen Benutzervorgang von StoClien finden Sie in den Abschnitten "Nutzung" und "Vorgang" in Stoclien.htm. Um Stoclient.htmzu lesen, führen Sie Tutorial.exe im Hauptlernprogrammverzeichnis aus, und klicken Sie in der Tabelle der Lektionen auf die StoClien-Lektion. Alternativ können Sie auf Stoclien.htm klicken, nachdem Sie das Hauptverzeichnis des Tutorials im Windows Explorer gefunden haben. Weitere Informationen dazu, wie StoServe funktioniert und seine Dienste für StoClien verfügbar macht, finden Sie unter Stoserve.htm im Hauptverzeichnis des Lernprogramms. Beachten Sie, dass Sie die Stoserve.dll erstellen müssen, bevor Sie StoClien erstellen. Die Makefile für StoServe registriert diesen Server in der Systemregistrierung, sodass Sie StoServe erstellen müssen, bevor Sie versuchen, StoClien auszuführen.

Weitere Informationen zum Einrichten eines Systems zum Erstellen und Testen der Codebeispiele in dieser COM-Lernprogrammreihe finden Sie unter How to Build Samples. Die bereitgestellte Makefile -Datei (MAKEFILE) ist Microsoft NMAKE-kompatibel. Um einen Debugbuild zu erstellen, geben Sie den NMAKE-Befehl im Eingabeaufforderungsfenster aus.

Zur Vereinfachung wird für jedes Beispiel eine Projektdatei für die Verwendung in Microsoft Visual Studio bereitgestellt. Um das Projekt für das StoClien-Beispiel zu laden, führen Sie Visual Studio an der Eingabeaufforderung im Beispielverzeichnis wie folgt aus:

MSDEV STOCLIEN. DSP

Sie können auch auf die Datei "Stoclient.dsp" im Windows-Explorer doppelklicken, um ein Beispielprojekt in Visual Studio zu laden. In Visual Studio können Sie die C++-Klassen der Beispielquelle durchsuchen und in der Regel die anderen Bearbeitungskompilierungs-Debugvorgänge ausführen. Beachten Sie, dass im Rahmen des Server SDK die Kompilierung dieser Beispiele aus Visual Studio die richtige Einstellung von Verzeichnispfaden in Visual Studio erfordert. Weitere Informationen finden Sie unter How to Build Samples.

Bemerkungen

Das Clientbeispiel und andere verwandte Beispiele müssen kompiliert werden, bevor Sie den Client ausführen können. Weitere Informationen zum Erstellen der Beispiele finden Sie unter How to Build Samples. Wenn Sie die entsprechenden Beispiele erstellt haben, ist Stoclien.exe die ausführbare Clientdatei, die für dieses Beispiel ausgeführt werden soll.

Die Stoclien.exe-Anwendung stellt die Benutzeroberfläche für dieses Lernprogramm bereit. Es übt die zugeordnete, aber unabhängige Stoserve.dll aus, um sowohl die Client- als auch die Serververwendung von COM-strukturierten Speicher in Verbunddateien zu veranschaulichen.