Funzione WlanOpenHandle (wlanapi.h)
La funzione WlanOpenHandle apre una connessione al server.
Sintassi
DWORD WlanOpenHandle(
[in] DWORD dwClientVersion,
PVOID pReserved,
[out] PDWORD pdwNegotiatedVersion,
[out] PHANDLE phClientHandle
);
Parametri
[in] dwClientVersion
La versione più recente dell'API WLAN supportata dal client.
| Valore | Significato |
|---|---|
|
Versione client per Windows XP con SP3 e API LAN wireless per Windows XP con SP2. |
|
Versione client per Windows Vista e Windows Server 2008 |
pReserved
Riservato per utilizzi futuri. Deve essere impostato su NULL.
[out] pdwNegotiatedVersion
Versione dell'API WLAN che verrà usata in questa sessione. Questo valore è in genere la versione più recente supportata sia dal client che dal server.
[out] phClientHandle
Handle per il client da usare in questa sessione. Questo handle viene usato da altre funzioni in tutta la sessione.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.
| Codice restituito | Descrizione |
|---|---|
|
pdwNegotiatedVersion è NULL, phClientHandle è NULL o pReserved non è NULL. |
|
Impossibile allocare memoria per creare il contesto client. |
|
Vari codici di errore. |
|
Troppi handle sono stati emessi dal server. |
Commenti
Il numero di versione specificato da dwClientVersion e pdwNegotiatedVersion è un numero di versione composito costituito da versioni principali e secondarie. La versione principale viene specificata dalla parola in ordine basso e la versione secondaria viene specificata dalla parola dell'ordine elevato. Le macro WLAN_API_VERSION_MAJOR(_v) e WLAN_API_VERSION_MINOR(_v) restituiscono rispettivamente i numeri di versione principale e secondaria. È possibile costruire un numero di versione usando la macro WLAN_API_MAKE_VERSION(_major, _minor).
Windows XP con SP3 e l'API LAN wireless per Windows XP con SP2: WlanOpenHandle restituirà un messaggio di errore se il servizio WZC (Wireless Zero Configuration) non è stato avviato o se il servizio WZC non è reattivo.
Requisiti
| Client minimo supportato | Windows Vista, Windows XP con SP3 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wlanapi.h (include Wlanapi.h) |
| Libreria | Wlanapi.lib |
| DLL | Wlanapi.dll |
| Componente ridistribuibile | API LAN wireless per Windows XP con SP2 |