WinCPICStartup
La función WinCPICStartup permite a una aplicación especificar la versión de la interfaz de programación común de Microsoft Windows para comunicaciones (CPI-C) necesaria y recuperar detalles de la implementación específica de Windows CPI-C. Una aplicación debe llamar a esta función para registrarse con una implementación de CPI-C de Windows antes de emitir más llamadas a CPI-C de Windows.
Sintaxis
INT WINAPI WinCPICStartup(
WORDwVersionRequired,
LPWCPICDATAlpwcpicdata);
Parámetros
wVersionRequired
Especifica la versión de compatibilidad con CPI-C 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.
lpwcpicdata
Puntero a la estructura de datos CPI-C. La estructura CPICDATA se define de la siguiente manera:
typedef struct {
....WORD wVersion;
char szDescription[WCPICDESCRIPTION_LEN+1];
} CPICDATA, FAR * LPWCPICDATA;
WCPIDESCRIPTION se define como 127 y los miembros de la estructura son los siguientes:
wVersion
La versión de Windows CPI-C compatible. 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.
szDescription
Cadena de descripción que describe la versión cpi-C admitida.
Valor devuelto
El valor devuelto especifica si la aplicación se registró correctamente y si la implementación de CPI-C de Windows puede admitir el número de versión especificado. Si el valor es cero, se registró correctamente. De lo contrario, el valor devuelto es uno de los siguientes:
WCPICSYSNOTRERADY
El sistema de red subyacente no está listo para la comunicación de red.
WCPICVERNOTSUPPORTED
Esta implementación de Windows CPI-C no proporciona la versión de soporte técnico de Windows CPI-C solicitada.
WCPICINVALID
La versión cpi-C de Windows especificada por la aplicación no es compatible con esta biblioteca de vínculos dinámicos (DLL).
Comentarios
Para admitir futuras implementaciones y aplicaciones de Windows CPI-C que pueden tener diferencias de funcionalidad de Windows CPI-C versión 1.0, se realiza una negociación en WinCPICStartup. Una aplicación pasa a WinCPICStartup la versión de Windows CPI-C que puede usar. Si esta versión es inferior a la versión más baja compatible con el ARCHIVO DLL cpi-C de Windows, el archivo DLL no puede admitir la aplicación y se produce un error en la llamada WinCPICStartup . Sin embargo, si la versión no es inferior, la llamada se realiza correctamente y devuelve la versión más alta de Windows CPI-C compatible con el archivo DLL. Si esta versión es inferior a la versión más baja compatible con la aplicación, la aplicación produce un error en su inicialización o intenta encontrar otro archivo DLL de Windows CPI-C en el sistema.
Esta negociación permite que tanto un ARCHIVO DLL de CPI-C de Windows como una aplicación cpi-C de Windows admitan una variedad de versiones de CPI-C 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 WinCPICStartup junto con diferentes versiones de aplicación y DLL.
| Versiones de la aplicación | Versiones de DLL | Para WinCPICStartup | Desde WinCPICStartup | 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 | WCPICINVALID | 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 CPI-C se describen en la estructura WHLLDATA definida de la siguiente manera:
typedef struct tagWCPICDATA { WORD wVersion;
char szDescription[WHLLDESCRIPTION_LEN+1];
} WCPICDATA, FAR *LPWCPICDATA;
Después de realizar su última llamada a CPI-C de Windows, una aplicación debe llamar a la rutina WinCPICCleanup.
Cada implementación de WINDOWS CPI-C debe realizar una llamada winCPICStartup antes de emitir otras llamadas CPI-C de Windows.