WinCPICStartup

La funzione WinCPICStartup consente a un'applicazione di specificare la versione di Microsoft Windows Common Programming Interface for Communications (CPI-C) richiesta 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 di Windows CPI-C prima di eseguire ulteriori chiamate a Windows CPI-C.

Sintassi

  
        INT WINAPI WinCPICStartup(   
WORDwVersionRequired,  
    LPWCPICDATAlpwcpicdata);  

Parametri

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

lpwcpicdata
Puntatore alla struttura dei 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 di 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 di CPI-C supportata.

Valore restituito

Il valore restituito specifica se l'applicazione è stata registrata correttamente e se l'implementazione di Windows CPI-C 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 di Windows CPI-C richiesta non è fornita da questa particolare implementazione di Windows CPI-C.

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

Osservazioni:

Per supportare future implementazioni e applicazioni di Windows CPI-C che potrebbero avere differenze di funzionalità rispetto a Windows CPI-C versione 1.0, viene eseguita una negoziazione in WinCPICStartup. Un'applicazione passa a WinCPICStartup la versione di Windows CPI-C che può usare. Se questa versione è inferiore alla versione più bassa supportata dalla DLL di Windows CPI-C, la DLL non può supportare l'applicazione e la chiamata WinCPICStartup non riesce. 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 non riesce l'inizializzazione o tenta di trovare un'altra DLL di Windows CPI-C nel sistema.

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

I dettagli dell'implementazione effettiva di Windows CPI-C 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 a Windows CPI-C, un'applicazione deve chiamare la routine WinCPICCleanup.

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