Funzione WlanIhvControl (wlanapi.h)

Articolo
03/04/2024

La funzione WlanIhvControl fornisce un meccanismo per il controllo indipendente del fornitore hardware (IHV) di driver o servizi WLAN.

Sintassi

DWORD WlanIhvControl(
  [in]                HANDLE                hClientHandle,
  [in]                const GUID            *pInterfaceGuid,
  [in]                WLAN_IHV_CONTROL_TYPE Type,
  [in]                DWORD                 dwInBufferSize,
  [in]                PVOID                 pInBuffer,
  [in]                DWORD                 dwOutBufferSize,
  [in, out, optional] PVOID                 pOutBuffer,
  [out]               PDWORD                pdwBytesReturned
);

Parametri

[in] hClientHandle

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

[in] pInterfaceGuid

GUID dell'interfaccia.

[in] Type

Struttura WLAN_IHV_CONTROL_TYPE che specifica il tipo di software ignorato dalla funzione di controllo IHV.

[in] dwInBufferSize

Dimensioni, in byte, del buffer di input.

[in] pInBuffer

Buffer generico per l'input dell'interfaccia del driver o del servizio.

[in] dwOutBufferSize

Dimensioni, in byte, del buffer di output.

[in, out, optional] pOutBuffer

Buffer generico per l'output dell'interfaccia del driver o del servizio.

[out] pdwBytesReturned

Numero di byte restituiti.

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_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti per eseguire questa operazione. Quando viene chiamato, WlanIhvControl recupera l'elenco di controllo di accesso discrezionale archiviato con l'oggetto wlan_secure_ihv_control . Se l'elenco dati non contiene una voce di controllo di accesso (ACE) che concede l'autorizzazione WLAN_WRITE_ACCESS al token di accesso del thread chiamante, WlanIhvControl restituisce ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle è NULL o non valido, pInterfaceGuid è NULL o pdwBytesReturned è 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.

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

Vedi anche

WLAN_IHV_CONTROL_TYPE

Condividi tramite