WinCPICStartup

Mit der WinCPICStartup-Funktion kann eine Anwendung die erforderliche Version von Microsoft Windows Common Programming Interface for Communications (CPI-C) angeben und Details zur spezifischen Windows CPI-C-Implementierung abrufen. Diese Funktion muss von einer Anwendung aufgerufen werden, um sich bei einer Windows CPI-C-Implementierung zu registrieren, bevor weitere Windows CPI-C-Aufrufe ausgegeben werden.

Syntax

  
        INT WINAPI WinCPICStartup(   
WORDwVersionRequired,  
    LPWCPICDATAlpwcpicdata);  

Parameter

wVersionRequired
Gibt die erforderliche Version der Windows CPI-C-Unterstützung an. Das hochgeordnete Byte gibt die Nebenversionsnummer (Revisionsnummer) an. Das Byte mit niedriger Reihenfolge gibt die Hauptversionsnummer an.

lpwcpicdata
Ein Zeiger auf die CPI-C-Datenstruktur. Die CPICDATA-Struktur ist wie folgt definiert:

typedef struct {  
....WORD wVersion;  
    char szDescription[WCPICDESCRIPTION_LEN+1];  
}  CPICDATA, FAR * LPWCPICDATA;  

WCPIDESCRIPTION ist als 127 definiert, und die Strukturmitglieder lauten wie folgt:

wVersion

Die unterstützte Version von Windows CPI-C. Das hochgeordnete Byte gibt die Nebenversionsnummer (Revisionsnummer) an. Das Byte mit niedriger Reihenfolge gibt die Hauptversionsnummer an.

szDescription

Die Beschreibungszeichenfolge, die die unterstützte CPI-C-Version beschreibt.

Rückgabewert

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

WCPICSYSNOTRERADY
Das zugrunde liegende Netzwerksystem ist nicht bereit für die Netzwerkkommunikation.

WCPICVERNOTSUPPORTED
Die angeforderte Version der Windows CPI-C-Unterstützung wird von dieser speziellen Windows CPI-C-Implementierung nicht bereitgestellt.

WCPICINVALID
Die von der Anwendung angegebene Windows CPI-C-Version wird von dieser DLL (Dynamic Link Library) nicht unterstützt.

Hinweise

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

Diese Aushandlung ermöglicht es sowohl einer Windows CPI-C-DLL als auch einer Windows CPI-C-Anwendung, eine Reihe von Windows CPI-C-Versionen zu unterstützen. Eine Anwendung kann eine DLL erfolgreich verwenden, wenn es eine Überlappung in den Versionen gibt. In der folgenden Tabelle wird veranschaulicht, wie WinCPICStartup in Verbindung mit verschiedenen Anwendungs- und DLL-Versionen funktioniert.

Anwendungsversionen	DLL-Versionen	Zu WinCPICStartup	Von WinCPICStartup	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	WCPICINVALID	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

Details zur tatsächlichen Windows CPI-C-Implementierung werden in der WHLLDATA-Struktur wie folgt beschrieben:

typedef struct tagWCPICDATA { WORD wVersion;  
            char szDescription[WHLLDESCRIPTION_LEN+1];  
            } WCPICDATA, FAR *LPWCPICDATA;  

Nach dem letzten Windows CPI-C-Aufruf sollte eine Anwendung die WinCPICCleanup-Routineaufrufen.

Jede Windows CPI-C-Implementierung muss einen WinCPICStartup-Aufruf ausführen, bevor andere Windows CPI-C-Aufrufe ausgegeben werden.