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 mit einer Windows APPC-Implementierung zu registrieren, bevor weitere Windows APPC-Aufrufe ausgestellt 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 der Windows APPC-Unterstützung an. Das Byte mit hoher Reihenfolge gibt die Nebenversionsnummer (Revision) an; Das Byte mit niedriger Reihenfolge gibt die Hauptversionsnummer an. Die aktuelle Version der Windows APPC-API ist 1.0.

lpAPPCData
Zeigen Sie 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 für die Netzwerkkommunikation bereit.

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.

Bemerkungen

Um zukünftige Windows APPC-Implementierungen und -Anwendungen zu unterstützen, die möglicherweise Funktionalitätsunterschiede von Windows APPC Version 1.0 aufweisen, findet eine Aushandlung in WinAPPCStartup statt. Eine Anwendung übergibt an WinAPPCStartup die Windows APPC-Version, die sie verwenden kann. Wenn diese Version niedriger als die niedrigste version ist, 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, wird der Aufruf erfolgreich ausgeführt 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 Anwendung entweder die Initialisierung fehl oder versucht, eine andere Windows APPC-DLL auf dem System zu finden.

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

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

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

Die Strukturmmber 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.

Nachdem der letzte Windows APPC-Aufruf ausgeführt wurde, sollte eine Anwendung die WinAPPCCleanup-Routine aufrufen.

Jede Windows APPC-Implementierung muss vor dem Ausgeben anderer Windows APPC-Aufrufe einen WinAPPCStartup-Aufruf ausführen.