DOT11EXTIHV_CREATE_DISCOVERY_PROFILES funzione di callback (wlanihv.h)

Il sistema operativo chiama la funzione Dot11ExtIhvCreateDiscoveryProfiles per restituire frammenti temporanei di connettività e profilo di sicurezza che possono essere usati per connettersi a una rete BSS (Basic Service Set) per cui non esiste un profilo di rete.

Sintassi

DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Dot11extihvCreateDiscoveryProfiles;

DWORD Dot11extihvCreateDiscoveryProfiles(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           BOOL bInsecure,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDOT11EXT_IHV_DISCOVERY_PROFILE_LIST pIhvDiscoveryProfileList,
  [out]          PDWORD pdwReasonCode
)
{...}

Parametri

[in, optional] hIhvExtAdapter

Handle utilizzato dalla DLL delle estensioni IHV per fare riferimento alla scheda LAN wireless (WLAN). Questo valore handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in] bInsecure

Valore booleano che specifica lo stato di sicurezza dei profili di individuazione. Se impostata su TRUE, la DLL delle estensioni IHV può restituire solo profili sicuri, ad esempio profili che comportano l'autenticazione utente.

[in, optional] pIhvProfileParams

Puntatore a DOT11EXT_IHV_PROFILE_PARAMS struttura. Questa struttura definisce gli attributi della rete BSS (Basic Service Set) a cui verranno applicate le estensioni del profilo.

[in, optional] pConnectableBssid

Puntatore a una struttura di DOT11_BSS_LIST , che contiene uno o più frame beacon o probe di risposta 802.11 ricevuti da una rete BSS. Questo elenco è derivato dai risultati dell'ultima operazione di analisi eseguita dalla scheda WLAN. Per altre informazioni sull'operazione di analisi, vedere Operazioni di analisi native 802.11.

[out] pIhvDiscoveryProfileList

Puntatore a DOT11EXT_IHV_DISCOVERY_PROFILE_LIST struttura che specifica un elenco di profili di individuazione IHV.

[out] pdwReasonCode

Puntatore a un valore DWORD, che fornisce informazioni aggiuntive per il valore restituito della funzione Dot11ExtIhvCreateDiscoveryProfiles . La DLL delle estensioni IHV deve impostare * pdwReasonCode su un valore L2_REASON_CODE_xxxx, definito in L2cmn.h.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Commenti

Al termine di un'operazione di analisi, il sistema operativo potrebbe chiamare Dot11ExtIhvCreateDiscoveryProfiles per creare frammenti di profilo temporanei che potrebbero essere utilizzati per connettersi a una rete BSS per cui non è stato creato un profilo di rete dall'utente.

Quando viene chiamato Dot11ExtIhvCreateDiscoveryProfiles , la DLL delle estensioni IHV deve seguire queste linee guida.

• Se la DLL delle estensioni IHV può restituire frammenti di profilo che possono essere usati per connettersi alla rete BSS, la funzione Dot11ExtIhvCreateDiscoveryProfiles deve restituire ERROR_SUCCESS. In caso contrario, la funzione deve restituire un codice di errore appropriato dai valori ERROR_xxxx definiti in Winerror.h.
• La DLL delle estensioni IHV fornisce altre informazioni sul risultato restituito della funzione Dot11ExtIhvCreateDiscoveryProfiles . La DLL deve impostare * pdwReasonCode su uno dei seguenti:
  • L2_REASON_CODE_SUCCESS, se è possibile restituire frammenti di profilo per l'elenco delle reti BSS.
  • Valore di errore L2_REASON_CODE_xxxx appropriato, se i frammenti di profilo non possono essere restituiti per l'elenco delle reti BSS.
  • Valore definito da IHV nell'intervallo compreso tra L2_REASON_CODE_IHV_BASE e (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), indipendentemente dal fatto che vengano restituiti frammenti di profilo.

Requisiti

Vedi anche

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtAllocateBuffer

DOT11EXT_IHV_PROFILE_PARAMS