WinCSVStartup

Mit der WinCSVStartup-Funktion kann eine Anwendung die erforderliche Version von Windows CSV angeben und Details zur spezifischen Windows CSV-Implementierung abrufen. Diese Funktion muss von einer Anwendung aufgerufen werden, um sich bei einer Windows CSV-Implementierung zu registrieren, bevor weitere Windows CSV-Aufrufe ausgegeben werden.

Syntax

  
int WINAPI WinCSVStartup(   
WORD wVersionRequired,  
LPWCSVDATA lpwcsvdata  
);  

Parameter

wVersionRequired
Gibt die erforderliche Version von Windows CSV-Unterstützung an. Das Byte mit hoher Ordnung gibt die Nummer der Nebenversion (Revision) an. das Byte in niedriger Reihenfolge gibt die Hauptversionsnummer an. Die aktuelle Version der Windows CSV-API ist 1.0.

lpwcsvdata
Ein Zeiger auf die CSV-Datenstruktur. Die CSVDATA-Struktur ist wie folgt definiert:

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

wobei WCSVDESCRIPTION als 127 definiert ist, und die Strukturmember wie folgt lauten:

wVersion

Die unterstützte Version von Windows CSV. Das Byte mit hoher Ordnung gibt die Nummer der Nebenversion (Revision) an. das Byte in niedriger Reihenfolge gibt die Hauptversionsnummer an.

szDescription

Eine Beschreibungszeichenfolge, die den Anbieter der Windows-CSV-DLL identifiziert.

Diese CVSDATA-Struktur enthält Informationen zur zugrunde liegenden Windows CSV-DLL-Implementierung. Das erste wVersion-Feld hat dieselbe Struktur wie der wVersionRequired-Parameter , und das Feld szDescription enthält eine Zeichenfolge, die den Anbieter der Windows CSV-DLL identifiziert. Das Beschreibungsfeld dient nur zur Bereitstellung einer Anzeigezeichenfolge für die Anwendung und sollte nicht zur programmgesteuerten Unterscheidung zwischen Windows CSV-Implementierungen verwendet werden.

Rückgabewerte

Der Rückgabewert gibt an, ob die Anwendung erfolgreich registriert wurde und ob die Windows CSV-Implementierung die angegebene Versionsnummer unterstützen kann. Wenn der Wert null ist, wurde er erfolgreich registriert. Andernfalls ist der Rückgabewert einer der folgenden:

WCSVSYSNOTREADY
Gibt an, dass das zugrunde liegende Netzwerksystem nicht für die Netzwerkkommunikation bereit ist.

WCSVVERNOTSUPPORTED
Die angeforderte Version der Windows CSV-Unterstützung wird von dieser speziellen Windows CSV-Implementierung nicht bereitgestellt.

WCSVINVALID
Die von der Anwendung angegebene Windows-CSV-Version wird von dieser DLL nicht unterstützt.

Hinweise

Um zukünftige Windows CSV-Implementierungen und -Anwendungen zu unterstützen, die möglicherweise Funktionsunterschiede von Windows CSV Version 1.0 aufweisen, findet in WinCSVStartup eine Aushandlung statt. Eine Anwendung übergibt die windows-CSV-Version, die sie verwenden kann, an WinCSVStartup . Wenn diese Version niedriger als die niedrigste Version ist, die von der Windows-CSV-DLL unterstützt wird, kann die DLL die Anwendung nicht unterstützen, und WinCSVStartup schlägt fehl. Wenn die Version jedoch nicht niedriger ist, ist der Aufruf erfolgreich und gibt die höchste Version von Windows CSV 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 Initialisierung der Anwendung fehl oder versucht, eine andere Windows CSV-DLL auf dem System zu finden.

Diese Aushandlung ermöglicht es sowohl einer Windows-CSV-DLL als auch einer Windows CSV-Anwendung, eine Reihe von Windows CSV-Versionen zu unterstützen. Eine Anwendung kann erfolgreich eine DLL verwenden, wenn sich die Versionen überschneiden. Die folgende Tabelle veranschaulicht, wie WinCSVStartup in Verbindung mit verschiedenen Anwendungs- und DLL-Versionen funktioniert.

Anwendungsversionen	DLL-Versionen	Zu WinCSVStartup	Von WinCSVStartup	Ergebnis
1.0	1.0	1.0	1.0	Verwenden von 1.0
1.0, 2.0	1.0	2.0	1.0	Verwenden von 1.0
1.0	1.0, 2.0	1.0	2.0	Verwenden von 1.0
1.0	2.0, 3.0	1.0	WCSVINVALID	Fehler
2.0, 3.0	1.0	3.0	1.0	App schlägt fehl
1.0, 2.0, 3.0	1.0, 2.0, 3.0	3.0	3.0	Verwenden von 3.0

Nach dem letzten Windows CSV-Aufruf sollte eine Anwendung WinCSVCleanup aufrufen.

Jede Windows CSV-Implementierung muss einen WinCSVStartup-Aufruf ausführen, bevor andere Windows CSV-Aufrufe ausgeführt werden. Daher kann diese Funktion zu Initialisierungszwecken verwendet werden.