Condividi tramite

struttura INTF_ENTRY

  • Articolo

[INTF_ENTRY non è più supportato a partire da Windows Vista e Windows Server 2008. Usare invece l'API Native Wifi, che fornisce funzionalità simili. Per altre informazioni, vedere Informazioni sull'API Wifi nativa.

Contiene informazioni dettagliate su un'interfaccia richiesta da un client RPC.

Sintassi

typedef struct {
  LPWSTR   wszGuid;
  LPWSTR   wszDescr;
  DWORD    dwContext;
  ULONG    ulMediaState;
  ULONG    ulMediaType;
  ULONG    ulPhysicalMediaType;
  INT      nInfraMode;
  INT      nAuthMode;
  INT      nWepStatus;
  DWORD    dwCtlFlags;
  DWORD    dwDynFlags;
  DWORD    dwCapabilities;
  RAW_DATA rdNicCapabilities;
  RAW_DATA rdSSID;
  RAW_DATA rdBSSID;
  RAW_DATA rdBSSIDList;
  RAW_DATA rdStSSIDList;
  RAW_DATA rdCtrlData;
} INTF_ENTRY, *PINTF_ENTRY;

Membri

wszGuid

Puntatore al GUID dell'interfaccia rappresentato come stringa Unicode nel formato seguente: "{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}".

wszDescr

Puntatore a una stringa contenente la descrizione dell'interfaccia recuperata dal servizio Wireless Zero Configuration (WZCSVC).

dwContext

Riservato a un uso interno.

ulMediaState

Stato di connessione del supporto NDIS corrente per l'interfaccia. Nella tabella seguente sono illustrati i possibili valori.

Valore Significato
MEDIA_STATE_CONNECTED
1
 Il supporto è connesso.
MEDIA_STATE_DISCONNECTED
0
 Il supporto è disconnesso.
MEDIA_STATE_UNKNOWN
-1
 Lo stato del supporto è sconosciuto.

 

ulMediaType

Tipi di supporti NDIS attualmente utilizzati dalla scheda di interfaccia di rete. Quando viene eseguita una query, il valore di questo membro viene NdisMedium802_3 come definito nel file di intestazione Ndispnp.h .

ulPhysicalMediaType

Tipo di supporto NDIS per l'interfaccia. Quando viene eseguita una query, il valore di questo membro è NdisPhysicalMediumWirelessLan come definito nel file di intestazione Ndispnp.h .

nInfraMode

La modalità infrastruttura corrente 802.11 impostata sull'interfaccia.

nAuthMode

La modalità di autenticazione 802.11 corrente impostata sull'interfaccia.

Nella tabella seguente vengono illustrati i valori possibili per il parametro in base all'enumerazione NDIS_802_11_AUTHENTICATION_MODE definita nel file di intestazione NtDDNdis.h .

Valore Significato
Ndis802_11AuthModeOpen
1
 Autenticazione open system di I edizione Enterprise E 802.11.
Ndis802_11AuthModeShared
2
 Autenticazione condivisa di I edizione Enterprise E 802.11 che usa una chiave WEP (Wired Equivalent Privacy) precondi shared.
Ndis802_11AuthModeAutoSwitch
3
 Modalità switch automatico. Quando si usa la modalità commutatore automatico, la scheda di interfaccia di rete wireless prova prima la modalità di autenticazione condivisa. Se la modalità condivisa ha esito negativo, la scheda di interfaccia di rete tenta di usare la modalità di autenticazione aperta.
Ndis802_11AuthModeWPA
4
 Sicurezza dell'accesso protetto wireless (WPA). L'autenticazione viene eseguita tra il supplicante, l'autenticatore e il server di autenticazione tramite I edizione Enterprise E 802.1X. Le chiavi di crittografia sono dinamiche e vengono derivate tramite il processo di autenticazione.
Ndis802_11AuthModeWPpiattaforma di strumenti analitici K
5
 Sicurezza WPA con una chiave precondi shared. L'autenticazione viene eseguita tra il supplicante e l'autenticatore su I edizione Enterprise E 802.1X. Le chiavi di crittografia sono dinamiche e vengono derivate tramite la chiave precondivisa usata dal supplicante e dall'autenticatore.
Ndis802_11AuthModeWPANone
6
 Sicurezza WPA. L'autenticazione viene eseguita usando una chiave precondivisa senza autenticazione I edizione Enterprise E 802.1X. Le chiavi di crittografia sono statiche e sono derivate tramite la chiave precondivisa. Questa modalità è applicabile solo ai tipi di rete ad hoc.
Ndis802_11AuthModeWPA2
7
 Sicurezza WPA2. L'autenticazione viene eseguita tra il supplicante, l'autenticatore e il server di autenticazione tramite I edizione Enterprise E 802.1X. Le chiavi di crittografia sono dinamiche e vengono derivate tramite il processo di autenticazione.
Ndis802_11AuthModeWPA2PSK
8
 Specifica la sicurezza WPA2. L'autenticazione viene eseguita tra il supplicante e l'autenticatore su I edizione Enterprise E 802 1X. Le chiavi di crittografia sono dinamiche e vengono derivate tramite la chiave precondivisa usata dal supplicante e dall'autenticatore.
Ndis802_11AuthModeMax
9
 Valore massimo possibile per il valore di enumerazione NDIS_802_11_AUTHENTICATION_MODE . Questo non è un valore legale per la modalità di autenticazione.

 

nWepStatus

La modalità di crittografia 802.11 corrente impostata sull'interfaccia.

dwCtlFlags

Valore maschera di bit dei flag di controllo che indicano il funzionamento di WZCSVC nell'interfaccia.

Nella tabella seguente vengono illustrati i possibili valori di bit.

Valore Significato
INTFCTL_CM_MASK
0x0007
 Maschera di bit per la modalità di filtro di rete. INTFCTL_CM_MASK & dwCtlFlags generano un valore del tipo NDIS_802_11_NETWORK_INFRASTRUCTURE. Il valore risultante indica se WZCSVC si connette solo alle reti dell'infrastruttura, alle reti adhoc o a entrambi i tipi di reti.
INTFCTL_ENABLED
0x8000
 Indica se WZCSVC deve configurare l'interfaccia.
INTFCTL_FALLBACK
0x4000
 Se una rete preferita non è disponibile, questo valore indica se WZCSVC deve configurare automaticamente la scheda di interfaccia di rete per l'associazione a qualsiasi rete disponibile.
INTFCTL_OIDSSUPP
0x2000
 Indica se il driver NIC supporta tutti gli 802.11 OID richiesti da WZCSVC per funzionare.
INTFCTL_VOLATILE
0x1000
 Indica se i parametri del servizio per questa interfaccia devono essere conservati nel Registro di sistema.
Se questo valore è impostato, questi parametri sono volatili e non devono essere conservati nel Registro di sistema.
INTFCTL_POLICY
0x0800
 Indica se i parametri del servizio per questa interfaccia vengono inseriti da criteri di gruppo.
Se questo valore è impostato, i parametri del servizio vengono inseriti nel computer locale in base a Criteri di gruppo.
INTFCTL_8021XSUPP
0x1000
 Indica se il supporto 802.1X è abilitato.

 

dwDynFlags

Maschera di bit di flag dinamici che controllano il comportamento dinamico (non persistente e non statico) nell'interfaccia.

Questi bit sono utili per attivare modifiche dinamiche e temporanee nel modo in cui WZCSVC agisce sull'interfaccia. Nessuno di questi bit viene salvato in modo permanente nel Registro di sistema, quindi le impostazioni non sopravvivono a un riavvio del sistema o a un dispositivo disabilitano e abilitano la sequenza.

Nella tabella seguente vengono illustrati i possibili valori di bit.

Valore Significato
INTFDYN_NOSCAN
0x00000001
 Indica che WZCSVC non deve richiedere l'interfaccia di eseguire un'analisi attiva, ma usare invece i valori memorizzati nella cache nel driver della scheda di interfaccia di rete.

 

dwCapabilities

Specifica le funzionalità del driver.

Valore Significato
INTFCAP_MAX_CIPHER_MASK
0x000000ff
 I bit di ordine inferiore di questo membro vengono usati per indicare la crittografia massima supportata. I valori possibili sono alcuni dei valori di enumerazione definiti nella struttura NDIS_802_11_WEP_STATUS nel file di intestazione NtDDNdis.h incluso in Windows SDK.
Il valore Ndis802_11Encryption1Enabled (2) indica che wep è supportato. TKIP e AES non sono supportati e una chiave di trasmissione potrebbe essere disponibile o meno.
Il valore Ndis802_11Encryption2Enabled (9) indica che TKIP e WEP sono supportati. AES non è supportato e è disponibile una chiave di trasmissione.
Il valore Ndis802_11Encryption3Enabled (11) indica che AES, TKIP e WEP sono supportati e una chiave di trasmissione è disponibile.
Il Ndis802_11EncryptionNotSupported (8) indica che la chiave WEP non è supportata.
INTFCAP_SSN
0x00000100
 Indica il supporto per Simple Secure Network (SSN) che è un subset 802.11i.
SSN modifica periodicamente la chiave di crittografia, anziché lo standard WEP (Cab cablato equivalente privacy), che usa una chiave statica. Per consentire il funzionamento di SSN, la crittografia massima supportata deve essere almeno TKIP. SSN è stato sviluppato da un consorzio di fornitori nel 2002 come approccio provvisorio per migliorare la sicurezza lan wireless mentre lo standard I edizione Enterprise E 802.11i è stato completato.
INTFCAP_80211I
0x00000200
 Indica il supporto per lo standard I edizione Enterprise E 802.11i.

 

rdNicCapabilities

Set di funzionalità per 802.11i.

La funzione WZCQueryInterface restituisce i dati rdNicCapabilities quando viene chiamato con il flag INTF_CAPABILITIES passato nel parametro dwInflags. Se la chiamata di funzione ha esito positivo, il membro pData della struttura RAW_DATA contiene una struttura INTF_80211_CAPABILITY .

rdSSID

Dati binari contenenti l'SSID 802.11 attualmente configurato nell'interfaccia.

La funzione WZCQueryInterface restituisce dati rdSSID quando viene chiamato con il flag INTF_SSID passato nel parametro dwInflags . Se la chiamata di funzione ha esito positivo, il membro dwDataLen della struttura RAW_DATA contiene il membro SsidLength di una struttura NDIS_802_11_SSID e il membro pData della struttura RAW_DATA contiene il membro Ssid di una struttura NDIS_802_11_SSID .

La struttura NDIS_802_11_SSID è definita nel file di intestazione Ntddndis.h .

rdBSSID

Dati binari contenenti il BSSID 802.11 configurato nell'interfaccia .

La funzione WZCQueryInterface restituisce dati rdBSSID quando viene chiamato con il flag INTF_BSSID passato nel parametro dwInflags. Se la chiamata di funzione ha esito positivo, il membro dwDataLen della struttura RAW_DATA contiene le dimensioni di una struttura NDIS_802_11_MAC_ADDRESS e il membro pData della struttura RAW_DATA contiene la struttura NDIS_802_11_MAC_ADDRESS .

La struttura NDIS_802_11_MAC_ADDRESS è definita nel file di intestazione Ntddndis.h .

rdBSSIDList

Dati binari che contengono l'elenco di BSSID che sono stati recuperati per l'ultima volta da WZCSVC.

La funzione WZCQueryInterface restituisce i dati rdBSSIDList quando viene chiamato con il flag INTF_BSSIDLIST passato nel parametro dwInflags. Se la chiamata di funzione ha esito positivo, il membro dwDataLen della struttura RAW_DATA contiene la lunghezza del buffer con i dati restituiti e il membro pData della struttura RAW_DATA contiene la struttura WZC_802_11_CONFIG_LIST .

rdStSSIDList

Dati binari che contengono l'elenco delle reti preferite configurate per questa interfaccia.

La funzione WZCQueryInterface restituisce dati rdStSSIDList quando viene chiamato con il flag INTF_PREFLIST passato nel parametro dwInflags. Se la chiamata di funzione ha esito positivo, il membro dwDataLen della struttura RAW_DATA contiene la lunghezza del buffer con i dati restituiti e il membro pData della struttura RAW_DATA contiene la struttura WZC_802_11_CONFIG_LIST .

Se una delle reti preferite è attualmente connessa, il membro dwCtlFlags della struttura WZC_WLAN_CONFIG per la rete avrà il bit WZCCTL_MEDIA_CONNECTED (0x0400).

rdCtrlData

Dati binari usati con altri flag di controllo, quando si impostano parametri aggiuntivi sull'interfaccia.

Osservazioni:

La struttura INTF_ENTRY viene usata dalle funzioni WZCQueryInterface e WZCRefreshInterface.

La struttura RAW_DATA è definita come segue:

typedef struct
{
    DWORD   dwDataLen;
    LPBYTE  pData;
} RAW_DATA, *PRAW_DATA;

Il membro pData punta ai dati binari. DwDataLen indica il numero di byte puntati da pData.

Nota

Il file di intestazione Wzcsapi.h non è disponibile in Windows SDK.

 

Requisiti

Requisito Valore
Client minimo supportato
 Windows XP con SP2 [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Fine del supporto client
 Windows XP con SP3
Supporto della fine del server
 Windows Server 2003
Intestazione
Wzcsapi.h

Vedi anche

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface