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
1
Versione client per Windows XP con SP3 e API LAN wireless per Windows XP con SP2.
2
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
ERROR_INVALID_PARAMETER
pdwNegotiatedVersion è NULL, phClientHandle è NULL o pReserved non è NULL.
ERROR_NOT_ENOUGH_MEMORY
Impossibile allocare memoria per creare il contesto client.
RPC_STATUS
Vari codici di errore.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
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

Vedi anche

WlanCloseHandle