WinCPICStartup

La funzione WinCPICStartup consente a un'applicazione di specificare la versione di Microsoft Windows Common Programming Interface for Communications (CPI-C) necessaria e di recuperare i dettagli dell'implementazione specifica di Windows CPI-C. Questa funzione deve essere chiamata da un'applicazione per registrarsi con un'implementazione CPI-C di Windows prima di emettere ulteriori chiamate CPI-C di Windows.

Sintassi

  
        INT WINAPI WinCPICStartup(   
WORDwVersionRequired,  
    LPWCPICDATAlpwcpicdata);  

Parametri

wVersionRequired
Specifica la versione del supporto CPI-C di Windows richiesto. Il byte ad ordine elevato specifica il numero di versione secondaria (revisione). Il byte a basso ordine specifica il numero di versione principale.

lpwcpicdata
Puntatore alla struttura di dati CPI-C. La struttura CPICDATA è definita come segue:

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

WCPIDESCRIPTION è definito come 127 e i membri della struttura sono i seguenti:

wVersion

Versione di Windows CPI-C supportata. Il byte ad ordine elevato specifica il numero di versione secondaria (revisione). Il byte a basso ordine specifica il numero di versione principale.

szDescription

Stringa di descrizione che descrive la versione CPI-C supportata.

Valore restituito

Il valore restituito specifica se l'applicazione è stata registrata correttamente e se l'implementazione CPI-C di Windows può supportare il numero di versione specificato. Se il valore è zero, è stato registrato correttamente. In caso contrario, il valore restituito è uno dei seguenti:

WCPICSYSNOTRERADY
Il sistema di rete sottostante non è pronto per la comunicazione di rete.

WCPICVERNOTSUPPORTED
La versione del supporto CPI-C di Windows richiesta non è fornita da questa particolare implementazione CPI-C di Windows.

WCPICINVALID
La versione CPI-C di Windows specificata dall'applicazione non è supportata da questa libreria di collegamento dinamico (DLL).

Commenti

Per supportare le future implementazioni e applicazioni CPI-C di Windows che potrebbero avere differenze di funzionalità rispetto a CPI-C di Windows versione 1.0, si svolge una negoziazione in WinCPICStartup. Un'applicazione passa a WinCPICStartup la versione CPI-C di Windows che può usare. Se questa versione è inferiore alla versione più bassa supportata dalla DLL CPI-C di Windows, la DLL non può supportare l'applicazione e la chiamata WinCPICStartup ha esito negativo. Se la versione non è inferiore, tuttavia, la chiamata ha esito positivo e restituisce la versione più alta di Windows CPI-C supportata dalla DLL. Se questa versione è inferiore alla versione più bassa supportata dall'applicazione, l'applicazione ha esito negativo o tenta di trovare un'altra DLL CPI-C di Windows nel sistema.

Questa negoziazione consente sia a una DLL CPI-C windows che a un'applicazione CPI-C di Windows di supportare un'ampia gamma di versioni CPI-C di Windows. Un'applicazione può usare correttamente una DLL se è presente una sovrapposizione nelle versioni. La tabella seguente illustra il funzionamento di WinCPICStartup insieme a diverse versioni di applicazione e DLL.

Versioni dell'applicazione	Versioni DLL	Per WinCPICStartup	Da WinCPICStartup	Risultato
1.0	1.0	1.0	1.0	Usare 1.0
1.0, 2.0	1.0	2,0	1.0	Usare 1.0
1,0	1.0, 2.0	1.0	2,0	Usare 1.0
1.0	2.0, 3.0	1,0	WCPICINVALID	Esito negativo
2.0, 3.0	1,0	3.0	1.0	L'app ha esito negativo
1.0, 2.0, 3.0	1.0, 2.0, 3.0	3,0	3,0	Usare 3.0

I dettagli dell'implementazione effettiva di CPI-C di Windows sono descritti nella struttura WHLLDATA definita come segue:

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

Dopo aver effettuato l'ultima chiamata CPI-C di Windows, un'applicazione deve chiamare la routine WinCPICCleanup.

Ogni implementazione CPI-C di Windows deve effettuare una chiamata WinCPICStartup prima di inviare qualsiasi altra chiamata CPI-C di Windows.