WinCSVStartup

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

Sintaxis

  
int WINAPI WinCSVStartup(   
WORD wVersionRequired,  
LPWCSVDATA lpwcsvdata  
);  

Parámetros

wVersionRequired
Especifica la versión de compatibilidad con CSV 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 csv de Windows es la 1.0.

lpwcsvdata
Puntero a la estructura de datos CSV. La estructura CSVDATA se define de la siguiente manera:

typedef struct tagWCSVDATA {  
    WORD wVersion;  
    char szDescription[WCSVDESCRIPTION_LEN+1];  
}  CSVDATA, FAR * LPWCSVCDATA;  

donde WCSVDESCRIPTION se define como 127 y los miembros de la estructura son los siguientes:

wVersion

La versión de CSV de Windows 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 identifica al proveedor del archivo DLL csv de Windows.

Esta estructura CVSDATA proporciona información sobre la implementación de DLL de CSV de Windows subyacente. El primer campo wVersion tiene la misma estructura que el parámetro wVersionRequired y el campo szDescription contiene una cadena que identifica al proveedor del archivo DLL csv de Windows. El campo de descripción solo está diseñado para proporcionar una cadena de presentación para la aplicación y no debe usarse para distinguir mediante programación entre implementaciones csv de Windows.

Valores devueltos

El valor devuelto especifica si la aplicación se registró correctamente y si la implementación de CSV 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:

WCSVSYSNOTREADY
Indica que el sistema de red subyacente no está listo para la comunicación de red.

WCSVVERNOTSUPPORTED
Esta implementación de WINDOWS CSV no proporciona la versión de compatibilidad con CSV de Windows solicitada.

WCSVINVALID
Esta DLL no admite la versión csv de Windows especificada por la aplicación.

Comentarios

Para admitir futuras implementaciones y aplicaciones de CSV de Windows que pueden tener diferencias de funcionalidad con respecto a la versión 1.0 de Windows CSV, se realiza una negociación en WinCSVStartup. Una aplicación pasa a WinCSVStartup la versión de CSV de Windows que puede usar. Si esta versión es inferior a la versión más baja compatible con el archivo DLL de Windows CSV, el archivo DLL no puede admitir la aplicación y WinCSVStartup 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 CSV de Windows compatible con el archivo DLL. Si esta versión es inferior a la versión más baja admitida por la aplicación, la aplicación produce un error en su inicialización o intenta encontrar otro archivo DLL csv de Windows en el sistema.

Esta negociación permite que tanto un archivo DLL csv de Windows como una aplicación CSV de Windows admitan una variedad de versiones CSV 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 WinCSVStartup junto con diferentes versiones de aplicación y DLL.

Versiones de la aplicación	Versiones de DLL	Para WinCSVStartup	Desde WinCSVStartup	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	WCSVINVALID	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

Después de realizar su última llamada CSV de Windows, una aplicación debe llamar a WinCSVCleanup.

Cada implementación de CSV de Windows debe realizar una llamada WinCSVStartup antes de emitir cualquier otra llamada CSV de Windows. Por lo tanto, esta función se puede usar con fines de inicialización.