Verwenden von StoServe

StoServe ist eine DLL, die hauptsächlich als COM-Server vorgesehen ist. Sie kann zwar implizit geladen werden, indem sie mit der zugeordneten LIB-Datei verknüpft wird, normalerweise wird sie aber nach einem expliziten LoadLibrary-Aufruf verwendet, normalerweise aus der COM-Funktion CoGetClassObject. StoServe ist ein sich selbst registrierender In-Process-Server.

Um StoServe zu verwenden, muss ein Client-Programm nicht STOSERVE.H beinhalten oder mit STOSERVE.LIB verknüpft sein. Ein COM-Client von StoServe erhält Zugriff ausschließlich über die CLSID- und COM-Dienste des Objekts. Für StoServe ist diese CLSID CLSID_DllPaper (definiert in der Datei PAPGUIDS.H im zugehörigen Verzeichnis \INC). Das StoClien-Codebeispiel zeigt, wie der Client diesen Zugriff erhält.

Der Makefile, den dieses Beispiel erstellt, registriert automatisch den Server in der Registrierung. Sie können die Selbstregistrierung manuell initiieren, indem Sie den folgenden Befehl an der Eingabeaufforderung im StoServe-Verzeichnis ausgeben:

nmake register

Dabei wird davon ausgegangen, dass Sie eine Kompilierungsumgebung eingerichtet haben. Wenn dies nicht der Fall ist, können Sie den Befehl REGISTER.EXE auch direkt in der Eingabeaufforderung aufrufen, während Sie sich im StoServe-Verzeichnis befinden.

..\register\register.exe stoserve.dll

Für diese Registrierungsbefehle sind ein vorheriger Build des REGISTER-Beispiels in dieser Reihe sowie ein vorheriger Build von STOSERVE.DLL erforderlich.

In dieser Reihe verwenden die Makefiles das REGISTER.EXE-Hilfsprogramm aus dem REGISTER-Beispiel. Aktuelle Versionen des Platform Software Development Kit (SDK) und Visual C++ umfassen ein Hilfsprogramm, REGSVR32.EXE, das auf ähnliche Weise zum Registrieren von In-Process-Servern und Marshalling-DLLs verwendet werden kann.

StoServe verwendet viele der Hilfsklassen und -dienste, die von APPUTIL bereitgestellt werden. Weitere Informationen zu APPUTIL finden Sie im Quellcode der APPUTIL-Bibliothek im gleichgeordneten APPUTIL-Verzeichnis und APPUTIL.HTM im Haupt-Lernprogrammverzeichnis.