Compartir a través de


WinAPPCStartup

La función WinAPPCStartup permite a una aplicación especificar la versión de Windows APPC necesaria y recuperar detalles de la implementación específica de AppC de Windows. Una aplicación debe llamar a esta función para registrarse con una implementación de APPC de Windows antes de emitir más llamadas a APPC de Windows.

Sintaxis

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

Parámetros

wVersionRequired
Especifica la versión de compatibilidad con AppC de Windows necesaria. El byte de orden superior especifica el número de versión secundaria (revisión); el byte de orden bajo especifica el número de versión principal. La versión actual de la API de Windows APPC es la 1.0.

lpAPPCData
Puntero a una estructura devuelta que contiene un número de versión de AppC de Windows y una descripción de la implementación de APPC de Windows.

Valor devuelto

El valor devuelto especifica si la aplicación se registró correctamente y si la implementación de APPC de Windows puede admitir el número de versión especificado. Si el valor es cero, se registró correctamente y se puede admitir la versión especificada. De lo contrario, el valor devuelto es uno de los siguientes:

WAPPCSYSNOTREADY
El sistema de red subyacente no está listo para la comunicación de red.

WAPPCVERNOTSUPPORTED
Esta implementación concreta de Windows APPC no proporciona la versión de soporte técnico de Windows APPC solicitada.

WAPPCINVALID
Esta DLL no admite la versión de APPC de Windows especificada por la aplicación.

Comentarios

Para admitir futuras implementaciones y aplicaciones de Windows APPC que pueden tener diferencias de funcionalidad con respecto a la versión 1.0 de Windows APPC, se realiza una negociación en WinAPPCStartup. Una aplicación pasa a WinAPPCStartup la versión de AppC de Windows que puede usar. Si esta versión es inferior a la versión más baja compatible con el archivo DLL de AppC de Windows, el archivo DLL no puede admitir la aplicación y WinAPPCStartup produce un error. Sin embargo, si la versión no es inferior, la llamada se realiza correctamente y devuelve la versión más alta de Windows APPC compatible con el archivo DLL. Si esta versión es inferior a la versión más baja compatible con la aplicación, se produce un error en la inicialización de la aplicación o se intenta encontrar otro archivo DLL de APPC de Windows en el sistema.

Esta negociación permite que tanto un archivo DLL de AppC de Windows como una aplicación appC de Windows admitan una variedad de versiones de APPC de Windows. Una aplicación puede usar correctamente un archivo DLL si hay alguna superposición en las versiones. En la tabla siguiente se muestra cómo funciona WinAPPCStartup junto con diferentes versiones de aplicación y DLL.

Versiones de la aplicación Versiones de DLL Para WinAPPCStartup Desde WinAPPCStartup Resultado
1.0 1.0 1.0 1.0 Uso de la versión 1.0
1.0, 2.0 1.0 2.0 1.0 Uso de la versión 1.0
1.0 1.0, 2.0 1.0 2.0 Uso de la versión 1.0
1.0 2.0, 3.0 1.0 WAPPCINVALID Suspenso
2.0, 3.0 1.0 3.0 1.0 Error en la aplicación
1.0, 2.0, 3.0 1.0, 2.0, 3.0 3.0 3.0 Uso de la versión 3.0

Los detalles de la implementación real de Windows APPC se describen en la estructura WAPPCDATA definida de la siguiente manera que devuelve WinAPPCStartup:

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

Los miembros de la estructura son los siguientes:

wVersion
Número de versión de APPC más alto admitido por el archivo DLL de AppC de Windows.

szDescription
Cadena descriptiva que describe la implementación de WinAPPC.

Después de realizar su última llamada APPC de Windows, una aplicación debe llamar a la rutina WinAPPCCleanup .

Cada implementación de APPC de Windows debe realizar una llamada WinAPPCStartup antes de emitir cualquier otra llamada APPC de Windows.