WinCSVStartup

La funzione WinCSVStartup consente a un'applicazione di specificare la versione di Windows CSV necessaria e di recuperare i dettagli dell'implementazione specifica di Csv di Windows. Questa funzione deve essere chiamata da un'applicazione per registrarsi con un'implementazione CSV di Windows prima di emettere ulteriori chiamate CSV di Windows.

Sintassi

  
int WINAPI WinCSVStartup(   
WORD wVersionRequired,  
LPWCSVDATA lpwcsvdata  
);  

Parametri

wVersionRequired
Specifica la versione del supporto CSV 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. La versione corrente dell'API CSV di Windows è 1.0.

lpwcsvdata
Puntatore alla struttura di dati CSV. La struttura CSVDATA è definita come segue:

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

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

wVersion

Versione di Windows CSV 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 identifica il fornitore della DLL CSV di Windows.

Questa struttura CVSDATA fornisce informazioni sull'implementazione della DLL CSV di Windows sottostante. Il primo campo wVersion ha la stessa struttura del parametro wVersionRequired e il campo szDescription contiene una stringa che identifica il fornitore della DLL CSV di Windows. Il campo descrizione è destinato solo a fornire una stringa di visualizzazione per l'applicazione e non deve essere usata per distinguere a livello di codice tra implementazioni CSV di Windows.

Valori restituiti

Il valore restituito specifica se l'applicazione è stata registrata correttamente e se l'implementazione csv 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:

WCSVSYSNOTREADY
Indica che il sistema di rete sottostante non è pronto per la comunicazione di rete.

WCSVVERNOTSUPPORTED
La versione del supporto CSV di Windows richiesta non è fornita da questa particolare implementazione csv di Windows.

WCSVINVALID
La versione CSV di Windows specificata dall'applicazione non è supportata da questa DLL.

Commenti

Per supportare le future implementazioni e applicazioni CSV di Windows che potrebbero avere differenze di funzionalità rispetto a Windows CSV versione 1.0, viene eseguita una negoziazione in WinCSVStartup. Un'applicazione passa a WinCSVStartup la versione csv di Windows che può essere usata. Se questa versione è inferiore alla versione più bassa supportata dalla DLL CSV di Windows, la DLL non può supportare l'applicazione e WinCSVStartup ha esito negativo. Se la versione non è inferiore, tuttavia, la chiamata ha esito positivo e restituisce la versione più alta di Windows CSV 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 CSV di Windows nel sistema.

Questa negoziazione consente sia a una DLL CSV windows che a un'applicazione CSV di Windows di supportare un intervallo di versioni CSV di Windows. Un'applicazione può usare correttamente una DLL se è presente una sovrapposizione nelle versioni. La tabella seguente illustra il funzionamento di WinCSVStartup insieme a diverse versioni dell'applicazione e della DLL.

Versioni dell'applicazione	Versioni DLL	Per WinCSVStartup	Da WinCSVStartup	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	WCSVINVALID	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

Dopo aver effettuato l'ultima chiamata CSV di Windows, un'applicazione deve chiamare WinCSVCleanup.

Ogni implementazione csv di Windows deve effettuare una chiamata WinCSVStartup prima di inviare altre chiamate CSV di Windows. Di conseguenza, questa funzione può essere usata per scopi di inizializzazione.