WinAPPCStartup

Mit der WinAPPCStartup-Funktion kann eine Anwendung die erforderliche Version von Windows APPC angeben und Details zur spezifischen Windows APPC-Implementierung abrufen. Eine Anwendung muss diese Funktion aufrufen, um sich bei einer Windows APPC-Implementierung zu registrieren, bevor weitere Windows APPC-Aufrufe ausgegeben werden.

Syntax

  
            int WINAPI WinAPPCStartup(   
        WORDwVersionRequired,  
        LPWAPPCDATAlpAPPCData  
);  
  
typedef struct {  
    WORD wVersion;  
    char szDescription[WAPPCDESCRIPTION_LEN+1];  
} WAPPCDATA, FAR * LPWAPPCDATA;  
  
where WAPPCDESCRIPTION_LEN is defined as 127  

Parameter

wVersionRequired
Gibt die erforderliche Version von Windows APPC-Unterstützung an. Das Byte mit hoher Ordnung gibt die Nummer der Nebenversion (Revision) an. das Byte in niedriger Reihenfolge gibt die Hauptversionsnummer an. Die aktuelle Version der Windows APPC-API ist 1.0.

lpAPPCData
Zeiger auf eine zurückgegebene Struktur, die eine Windows APPC-Versionsnummer und eine Beschreibung der Windows APPC-Implementierung enthält.

Rückgabewert

Der Rückgabewert gibt an, ob die Anwendung erfolgreich registriert wurde und ob die Windows APPC-Implementierung die angegebene Versionsnummer unterstützen kann. Wenn der Wert null ist, wurde er erfolgreich registriert, und die angegebene Version kann unterstützt werden. Andernfalls ist der Rückgabewert einer der folgenden:

WAPPCSYSNOTREADY
Das zugrunde liegende Netzwerksystem ist nicht bereit für die Netzwerkkommunikation.

WAPPCVERNOTSUPPORTED
Die angeforderte Version der Windows APPC-Unterstützung wird von dieser speziellen Windows APPC-Implementierung nicht bereitgestellt.

WAPPCINVALID
Die von der Anwendung angegebene Windows APPC-Version wird von dieser DLL nicht unterstützt.

Hinweise

Um zukünftige Windows APPC-Implementierungen und -Anwendungen zu unterstützen, die möglicherweise Funktionsunterschiede von Windows APPC Version 1.0 aufweisen, findet in WinAPPCStartup eine Aushandlung statt. Eine Anwendung übergibt an WinAPPCStartup die Windows APPC-Version, die sie verwenden kann. Wenn diese Version niedriger ist als die niedrigste Version, die von der Windows APPC-DLL unterstützt wird, kann die DLL die Anwendung nicht unterstützen, und WinAPPCStartup schlägt fehl. Wenn die Version jedoch nicht niedriger ist, ist der Aufruf erfolgreich und gibt die höchste Version von Windows APPC zurück, die von der DLL unterstützt wird. Wenn diese Version niedriger als die niedrigste von der Anwendung unterstützte Version ist, schlägt die Initialisierung der Anwendung fehl oder versucht, eine andere Windows APPC-DLL auf dem System zu finden.

Diese Aushandlung ermöglicht es sowohl einer Windows APPC-DLL als auch einer Windows APPC-Anwendung, eine Reihe von Windows APPC-Versionen zu unterstützen. Eine Anwendung kann erfolgreich eine DLL verwenden, wenn sich die Versionen überschneiden. Die folgende Tabelle veranschaulicht, wie WinAPPCStartup in Verbindung mit verschiedenen Anwendungs- und DLL-Versionen funktioniert.

Anwendungsversionen	DLL-Versionen	Zu WinAPPCStartup	Von WinAPPCStartup	Ergebnis
1.0	1.0	1.0	1.0	Verwenden von 1.0
1.0, 2.0	1.0	2.0	1.0	Verwenden von 1.0
1.0	1.0, 2.0	1.0	2.0	Verwenden von 1.0
1.0	2.0, 3.0	1.0	WAPPCINVALID	Fehler
2.0, 3.0	1.0	3.0	1.0	App schlägt fehl
1.0, 2.0, 3.0	1.0, 2.0, 3.0	3.0	3.0	Verwenden von 3.0

Details zur tatsächlichen Windows APPC-Implementierung werden in der WAPPCDATA-Struktur beschrieben, die wie folgt definiert ist und von WinAPPCStartup zurückgegeben wird:

typedef struct tagWAPPCDDATA { WORD wVersion;  
char szDescription[WAPPCDESCRIPTION_LEN+1];  
} WAPPCDATA, FAR *LPWAPPCDATA;  

Die Strukturmember sind wie folgt:

wVersion
Die höchste APPC-Versionsnummer, die von der Windows APPC-DLL unterstützt wird.

szDescription
Eine beschreibende Zeichenfolge, die die WinAPPC-Implementierung beschreibt.

Nach dem letzten Windows APPC-Aufruf sollte eine Anwendung die WinAPPCCleanup-Routine aufrufen.

Jede Windows APPC-Implementierung muss einen WinAPPCStartup-Aufruf ausführen, bevor andere Windows APPC-Aufrufe ausgeführt werden.