WinAPPCStartup

La funzione WinAPPCStartup consente a un'applicazione di specificare la versione di Windows APPC necessaria e di recuperare i dettagli dell'implementazione specifica di Windows APPC. Un'applicazione deve chiamare questa funzione per registrarsi con un'implementazione di Windows APPC prima di emettere ulteriori chiamate appC di Windows.

Sintassi

  
            int WINAPI WinAPPCStartup(   
        WORDwVersionRequired,  
        LPWAPPCDATAlpAPPCData  
);  
  
typedef struct {  
    WORD wVersion;  
    char szDescription[WAPPCDESCRIPTION_LEN+1];  
} WAPPCDATA, FAR * LPWAPPCDATA;  
  
where WAPPCDESCRIPTION_LEN is defined as 127  

Parametri

wVersionRequired
Specifica la versione del supporto appC 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 APPC di Windows è 1.0.

lpAPPCData
Puntatore a una struttura restituita contenente un numero di versione di Windows APPC e una descrizione dell'implementazione di Windows APPC.

Valore restituito

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

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

WAPPCVERNOTSUPPORTED
La versione del supporto appC di Windows richiesta non è fornita da questa particolare implementazione appC di Windows.

WAPPCINVALID
La versione appC di Windows specificata dall'applicazione non è supportata da questa DLL.

Commenti

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

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

Versioni dell'applicazione	Versioni DLL	Per WinAPPCStartup	Da WinAPPCStartup	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	WAPPCINVALID	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 Windows APPC sono descritti nella struttura WAPPCDATA definita come segue restituita da WinAPPCStartup:

typedef struct tagWAPPCDDATA { WORD wVersion;  
char szDescription[WAPPCDESCRIPTION_LEN+1];  
} WAPPCDATA, FAR *LPWAPPCDATA;  

I membri della struttura sono i seguenti:

wVersion
Numero di versione APPC più alto supportato dalla DLL appC di Windows.

szDescription
Stringa descrittiva che descrive l'implementazione di WinAPPC.

Dopo aver eseguito l'ultima chiamata appC di Windows, un'applicazione deve chiamare la routine WinAPPCCleanup .

Ogni implementazione di Windows APPC deve effettuare una chiamata WinAPPCStartup prima di inviare altre chiamate APPC di Windows.