WinCSVStartup

Mit der WinCSVStartup-Funktion kann eine Anwendung die erforderliche Windows-CSV-Version 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 ausgestellt werden.

Syntax

  
int WINAPI WinCSVStartup(   
WORD wVersionRequired,  
LPWCSVDATA lpwcsvdata  
);  

Parameter

wVersionRequired
Gibt die erforderliche Version der Windows-CSV-Unterstützung an. Das Byte mit hoher Reihenfolge gibt die Nebenversionsnummer (Revision) an; Das Byte mit 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 Strukturmmber wie folgt sind:

wVersion

Die von Windows CSV unterstützte Version. Das Byte mit hoher Reihenfolge gibt die Nebenversionsnummer (Revision) an; Das Byte mit 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 weist dieselbe Struktur wie der wVersionRequired-Parameter auf , und das SzDescription-Feld enthält eine Zeichenfolge, die den Anbieter der Windows-CSV-DLL identifiziert. Das Beschreibungsfeld soll nur eine Anzeigezeichenfolge für die Anwendung bereitstellen und sollte nicht verwendet werden, um programmgesteuert zwischen Windows-CSV-Implementierungen zu unterscheiden.

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 bestimmten Windows-CSV-Implementierung nicht bereitgestellt.

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

Bemerkungen

Zur Unterstützung zukünftiger Windows-CSV-Implementierungen und -Anwendungen, die möglicherweise Funktionsunterschiede von Windows CSV Version 1.0 aufweisen, erfolgt eine Aushandlung in WinCSVStartup. Eine Anwendung wird an WinCSVStartup der Windows-CSV-Version übergeben, die sie verwenden kann. 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, wird der Aufruf erfolgreich ausgeführt 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 version ist, die von der Anwendung unterstützt wird, schlägt die Anwendung entweder die Initialisierung fehl oder versucht, eine andere Windows-CSV-DLL auf dem System zu finden.

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

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 ausstellen. Folglich kann diese Funktion für Initialisierungszwecke verwendet werden.