WinAPPCStartup

La fonction WinAPPCStartup permet à une application de spécifier la version de Windows APPC requise et de récupérer les détails de l’implémentation windows APPC spécifique. Une application doit appeler cette fonction pour s’inscrire auprès d’une implémentation Windows APPC avant d’émettre d’autres appels Windows APPC.

Syntaxe

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

Paramètres

wVersionRequired
Spécifie la version de la prise en charge de Windows APPC requise. L’octet d’ordre élevé spécifie le numéro de version mineure (révision) ; l’octet d’ordre inférieur spécifie le numéro de version principale. La version actuelle de l’API Windows APPC est 1.0.

lpAPPCData
Pointeur vers une structure retournée contenant un numéro de version Windows APPC et une description de l’implémentation de Windows APPC.

Valeur renvoyée

La valeur de retour spécifie si l’application a été inscrite avec succès et si l’implémentation de Windows APPC peut prendre en charge le numéro de version spécifié. Si la valeur est zéro, elle a été inscrite avec succès et la version spécifiée peut être prise en charge. Sinon, la valeur de retour est l’une des suivantes :

WAPPCSYSNOTREADY
Le système réseau sous-jacent n’est pas prêt pour la communication réseau.

WAPPCVERNOTSUPPORTED
La version de la prise en charge de Windows APPC demandée n’est pas fournie par cette implémentation Windows APPC particulière.

WAPPCINVALID
La version de Windows APPC spécifiée par l’application n’est pas prise en charge par cette DLL.

Remarques

Pour prendre en charge les futures implémentations et applications Windows APPC qui peuvent présenter des différences de fonctionnalités par rapport à Windows APPC version 1.0, une négociation a lieu dans WinAPPCStartup. Une application passe à WinAPPCStartup la version de Windows APPC qu’elle peut utiliser. Si cette version est inférieure à la version la plus basse prise en charge par la DLL Windows APPC, la DLL ne peut pas prendre en charge l’application et WinAPPCStartup échoue. Toutefois, si la version n’est pas inférieure, l’appel réussit et retourne la version la plus élevée de Windows APPC prise en charge par la DLL. Si cette version est inférieure à la version la plus basse prise en charge par l’application, l’application échoue à son initialisation ou tente de trouver une autre DLL AppC Windows sur le système.

Cette négociation permet à une DLL Windows APPC et à une application Windows APPC de prendre en charge une gamme de versions de Windows APPC. Une application peut utiliser correctement une DLL en cas de chevauchement des versions. Le tableau suivant illustre le fonctionnement de WinAPPCStartup conjointement avec différentes versions d’application et de DLL.

Les détails de l’implémentation réelle de Windows APPC sont décrits dans la structure WAPPCDATA définie comme suit, qui est retournée par WinAPPCStartup :

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

Les membres de la structure sont les suivants :

wVersion
Numéro de version APPC le plus élevé pris en charge par la DLL Windows APPC.

szDescription
Chaîne descriptive décrivant l’implémentation WinAPPC.

Après avoir passé son dernier appel Windows APPC, une application doit appeler la routine WinAPPCCleanup .

Chaque implémentation Windows APPC doit effectuer un appel WinAPPCStartup avant d’émettre d’autres appels Windows APPC.