Condividi tramite


Funzione WFDCloseHandle (wlanapi.h)

La funzione WFDCloseHandle chiude un handle al servizio Wi-Fi Direct.

Sintassi

DWORD WFDCloseHandle(
  [in] HANDLE hClientHandle
);

Parametri

[in] hClientHandle

Handle client al servizio Wi-Fi Direct. Questo handle è stato ottenuto da una chiamata precedente alla funzione WFDOpenHandle .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.

Codice restituito Descrizione
ERROR_INVALID_HANDLE
Handle non valido.

Questo errore viene restituito se l'handle specificato nel parametro hClientHandle non è stato trovato nella tabella handle.

ERROR_INVALID_PARAMETER
Parametro non corretto.

Questo errore viene restituito se il parametro hClientHandle è NULL o non valido.

RPC_STATUS
Vari codici di errore.

Commenti

La funzione WFDCloseHandle fa parte di Wi-Fi Direct, una nuova funzionalità in Windows 8 e Windows Server 2012. Wi-Fi Direct si basa sullo sviluppo della specifica tecnica peer-to-peer Wi-Fi dalla Wi-Fi Alliance (vedere Specifiche pubblicate di Wi-Fi Alliance). L'obiettivo della specifica tecnica peer-to-peer di Wi-Fi è fornire una soluzione per Wi-Fi connettività da dispositivo a dispositivo senza la necessità di un punto di accesso wireless (API wireless) per configurare la connessione o l'uso del meccanismo adhoc (IBSS) Wi-Fi esistente.

Per usare Wi-Fi Direct, un'applicazione deve prima ottenere un handle per il servizio Wi-Fi Direct chiamando la funzione WFDOpenHandle . L'handle Wi-Fi Direct (WFD) restituito dalla funzione WFDOpenHandle viene usato per le chiamate successive effettuate al servizio Wi-Fi Direct. Una volta eseguita l'uso di un'applicazione tramite il servizio diretto Wi-Fi, l'applicazione deve chiamare la funzione WFDCloseHandle per segnalare al servizio Wi-Fi Direct che l'applicazione viene eseguita usando il servizio. Ciò consente al servizio Wi-Fi Direct di rilasciare le risorse usate dall'applicazione.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wlanapi.h
Libreria Wlanapi.lib
DLL Wlanapi.dll

Vedi anche

WFDCancelOpenSession

WFDCloseSession

WFDOpenHandle

WFDOpenLegacySession

WFDStartOpenSession

WFDUpdateDeviceVisibility

WFD_OPEN_SESSION_COMPLETE_CALLBACK