Condividi tramite


Funzione WlanGetInterfaceCapability (wlanapi.h)

La funzione WlanGetInterfaceCapability recupera le funzionalità di un'interfaccia.

Sintassi

DWORD WlanGetInterfaceCapability(
  [in]  HANDLE                     hClientHandle,
  [in]  const GUID                 *pInterfaceGuid,
        PVOID                      pReserved,
  [out] PWLAN_INTERFACE_CAPABILITY *ppCapability
);

Parametri

[in] hClientHandle

Handle di sessione del client ottenuto da una chiamata precedente alla funzione WlanOpenHandle .

[in] pInterfaceGuid

GUID di questa interfaccia.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

[out] ppCapability

Struttura WLAN_INTERFACE_CAPABILITY che contiene informazioni sulle funzionalità dell'interfaccia specificata.

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_PARAMETER
hClientHandle è NULL o non valido, pInterfaceGuid è NULL, pReserved non è NULL o ppCapability è NULL.
ERROR_INVALID_HANDLE
L'handle hClientHandle non è stato trovato nella tabella handle.
ERROR_NOT_SUPPORTED
Questa funzione è stata chiamata da una piattaforma non supportata. Questo valore verrà restituito se questa funzione è stata chiamata da un'API Windows XP con SP3 o WIRELESS LAN per Windows XP con il client SP2.
RPC_STATUS
Vari codici di errore.

Commenti

Il chiamante è responsabile della chiamata alla funzione WlanFreeMemory per liberare la memoria allocata a ppCapability.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [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