Compartir a través de

estructura de INTF_ENTRY

  • Artículo

[INTF_ENTRY ya no se admite a partir de Windows Vista y Windows Server 2008. En su lugar, use la API De Wifi nativa, que proporciona una funcionalidad similar. Para obtener más información, consulte Acerca de la API de Wifi nativa.]

Contiene información detallada sobre una interfaz requerida por un cliente RPC.

Sintaxis

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;

Miembros

wszGuid

Puntero al GUID de interfaz representado como una cadena Unicode con el siguiente formato: "{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}".

wszDescr

Puntero a una cadena que contiene la descripción de la interfaz recuperada por el servicio Wireless Zero Configuration (WZCSVC).

dwContext

Reservado para uso interno.

ulMediaState

Estado actual de conexión de medios NDIS para la interfaz. En la siguiente tabla se muestran los valores posibles.

Valor Significado
MEDIA_STATE_CONNECTED
1
 El medio está conectado.
MEDIA_STATE_DISCONNECTED
0
 El medio está desconectado.
MEDIA_STATE_UNKNOWN
-1
 El estado multimedia es desconocido.

 

ulMediaType

Los tipos de medios NDIS que usa actualmente la NIC. Cuando se consulta, el valor de este miembro se NdisMedium802_3 tal como se define en el archivo de encabezado Ndispnp.h .

ulPhysicalMediaType

Tipo de medio NDIS para la interfaz. Cuando se consulta, el valor de este miembro es NdisPhysicalMediumWirelessLan como se define en el archivo de encabezado Ndispnp.h .

nInfraMode

El modo de infraestructura actual 802.11 establecido en la interfaz.

nAuthMode

El modo de autenticación 802.11 actual establecido en la interfaz .

En la tabla siguiente se muestran los valores posibles para el parámetro en función de la enumeración NDIS_802_11_AUTHENTICATION_MODE definida en el archivo de encabezado NtDDNdis.h .

Valor Significado
Ndis802_11AuthModeOpen
1
 Ieee 802.11 Abra la autenticación del sistema.
Ndis802_11AuthModeShared
2
 Autenticación compartida IEEE 802.11 que usa una clave de privacidad equivalente cableada previamente compartida (WEP).
Ndis802_11AuthModeAutoSwitch
3
 Modo de conmutador automático. Cuando se usa el modo de conmutador automático, la tarjeta de interfaz de red inalámbrica (NIC) intenta primero el modo de autenticación compartida. Si se produce un error en el modo compartido, la NIC intenta usar el modo de autenticación abierto.
Ndis802_11AuthModeWPA
4
 Seguridad de acceso protegido inalámbrico (WPA). La autenticación se realiza entre el suplicante, el autenticador y el servidor de autenticación a través de IEEE 802.1X. Las claves de cifrado son dinámicas y se derivan a través del proceso de autenticación.
Ndis802_11AuthModeWPAPSK
5
 Seguridad WPA mediante una clave precompartida. La autenticación se realiza entre el suplicante y el autenticador a través de IEEE 802.1X. Las claves de cifrado son dinámicas y se derivan a través de la clave precompartida utilizada por el suplicante y el autenticador.
Ndis802_11AuthModeWPANone
6
 Seguridad WPA. La autenticación se realiza mediante una clave precompartida sin autenticación IEEE 802.1X. Las claves de cifrado son estáticas y se derivan a través de la clave precompartida. Este modo solo se aplica a los tipos de red ad hoc.
Ndis802_11AuthModeWPA2
7
 Seguridad WPA2. La autenticación se realiza entre el suplicante, el autenticador y el servidor de autenticación a través de IEEE 802.1X. Las claves de cifrado son dinámicas y se derivan a través del proceso de autenticación.
Ndis802_11AuthModeWPA2PSK
8
 Especifica la seguridad WPA2. La autenticación se realiza entre el suplicante y el autenticador a través de IEEE 802 1X. Las claves de cifrado son dinámicas y se derivan a través de la clave precompartida utilizada por el suplicante y el autenticador.
Ndis802_11AuthModeMax
9
 Valor máximo posible para el valor de enumeración NDIS_802_11_AUTHENTICATION_MODE . Este no es un valor legal para el modo de autenticación.

 

nWepStatus

El modo de cifrado 802.11 actual establecido en la interfaz .

dwCtlFlags

Valor de máscara de bits de marcas de control que indican cómo funciona WZCSVC en la interfaz.

En la tabla siguiente se muestran los valores de bits posibles.

Valor Significado
INTFCTL_CM_MASK
0x0007
 Máscara de bits para el modo de filtro de red. & INTFCTL_CM_MASK dwCtlFlags da como resultado un valor del tipo NDIS_802_11_NETWORK_INFRASTRUCTURE. El valor resultante indica si WZCSVC solo se conecta a redes de infraestructura, redes addhoc o a ambos tipos de redes.
INTFCTL_ENABLED
0x8000
 Indica si WZCSVC debe configurar la interfaz.
INTFCTL_FALLBACK
0x4000
 Si una red preferida no está disponible, este valor indica si WZCSVC debe configurar automáticamente la NIC para asociarla a cualquier red disponible.
INTFCTL_OIDSSUPP
0x2000
 Indica si el controlador NIC admite todos los OID 802.11 requeridos por WZCSVC para funcionar.
INTFCTL_VOLATILE
0x1000
 Indica si los parámetros de servicio de esta interfaz deben conservarse en el Registro.
Si se establece este valor, estos parámetros son volátiles y no se deben conservar en el Registro.
INTFCTL_POLICY
0x0800
 Indica si una directiva de grupo inserta los parámetros de servicio para esta interfaz.
Si se establece este valor, la directiva de grupo inserta los parámetros de servicio en el equipo local.
INTFCTL_8021XSUPP
0x1000
 Indica si la compatibilidad con 802.1X está habilitada.

 

dwDynFlags

Máscara de bits de marcas dinámicas que controlan el comportamiento dinámico (no persistente y no estático) en la interfaz.

Estos bits son útiles para desencadenar cambios dinámicos y temporales en la forma en que el WZCSVC actúa en la interfaz. Ninguno de estos bits se conserva en el Registro, por lo que la configuración no sobrevivirá a un reinicio del sistema o a un dispositivo deshabilite y habilite la secuencia.

En la tabla siguiente se muestran los valores de bits posibles.

Valor Significado
INTFDYN_NOSCAN
0x00000001
 Indica que WZCSVC no debe solicitar que la interfaz realice un examen activo, sino que, en su lugar, use los valores almacenados en caché en el controlador NIC.

 

dwCapabilities

Especifica las funcionalidades del controlador.

Valor Significado
INTFCAP_MAX_CIPHER_MASK
0x000000ff
 Los bits de orden inferior de este miembro se usan para indicar el cifrado máximo admitido. Los valores posibles son algunos de los valores de enumeración definidos en la estructura NDIS_802_11_WEP_STATUS del archivo de encabezado NtDDNdis.h incluido en Windows SDK.
El valor de Ndis802_11Encryption1Enabled (2) indica que se admite WEP. No se admiteN TKIP y AES, y es posible que una clave de transmisión esté disponible o no.
El valor de Ndis802_11Encryption2Enabled (9) indica que se admiten TKIP y WEP. AES no se admite y hay disponible una clave de transmisión.
El valor de Ndis802_11Encryption3Enabled (11) indica que se admiten AES, TKIP y WEP, y que hay disponible una clave de transmisión.
El Ndis802_11EncryptionNotSupported (8) indica indica que no se admite la clave WEP.
INTFCAP_SSN
0x00000100
 Indica la compatibilidad con Simple Secure Network (SSN), que es un subconjunto de 802.11i.
SSN cambia periódicamente la clave de cifrado, en lugar del estándar WEP (privacidad equivalente cableada), que usa una clave estática. Para que el SSN funcione, el cifrado máximo admitido debe ser al menos TKIP. SSN fue desarrollado por un consorcio de proveedores en 2002 como un enfoque provisional para mejorar la seguridad de LAN inalámbrica mientras se completaba el estándar IEEE 802.11i.
INTFCAP_80211I
0x00000200
 Indica la compatibilidad con el estándar IEEE 802.11i.

 

rdNicCapabilities

Un conjunto de funcionalidades para 802.11i.

La función WZCQueryInterface devuelve datos rdNicCapabilities cuando se llama con la marca INTF_CAPABILITIES pasada en el parámetro dwInflags . Si la llamada de función se realiza correctamente, el miembro pData de la estructura RAW_DATA contiene una estructura INTF_80211_CAPABILITY .

rdSSID

Datos binarios que contienen el SSID 802.11 configurado actualmente en la interfaz.

La función WZCQueryInterface devuelve datos rdSSID cuando se llama con la marca INTF_SSID pasada en el parámetro dwInflags . Si la llamada a la función es correcta, el miembro dwDataLen de la estructura RAW_DATA contiene el miembro SsidLength de una estructura de NDIS_802_11_SSID y el miembro pData de la estructura RAW_DATA contiene el miembro Ssid de una estructura NDIS_802_11_SSID .

La estructura NDIS_802_11_SSID se define en el archivo de encabezado Ntddndis.h .

rdBSSID

Datos binarios que contienen el BSSID 802.11 configurado en la interfaz.

La función WZCQueryInterface devuelve datos rdBSSID cuando se llama con la marca de INTF_BSSID pasada en el parámetro dwInflags . Si la llamada de función se realiza correctamente, el miembro dwDataLen de la estructura RAW_DATA contiene el tamaño de una estructura de NDIS_802_11_MAC_ADDRESS y el miembro pData de la estructura RAW_DATA contiene la estructura NDIS_802_11_MAC_ADDRESS .

La estructura NDIS_802_11_MAC_ADDRESS se define en el archivo de encabezado Ntddndis.h .

rdBSSIDList

Datos binarios que contienen la lista de BSSID recuperados por última vez por WZCSVC.

La función WZCQueryInterface devuelve datos rdBSSIDList cuando se llama con la marca de INTF_BSSIDLIST pasada en el parámetro dwInflags . Si la llamada de función se realiza correctamente, el miembro dwDataLen de la estructura RAW_DATA contiene la longitud del búfer con los datos devueltos y el miembro pData de la estructura RAW_DATA contiene la estructura WZC_802_11_CONFIG_LIST .

rdStSSIDList

Datos binarios que contienen la lista de redes preferidas configuradas para esta interfaz.

La función WZCQueryInterface devuelve datos rdStSSIDList cuando se llama con la marca INTF_PREFLIST pasada en el parámetro dwInflags . Si la llamada de función se realiza correctamente, el miembro dwDataLen de la estructura RAW_DATA contiene la longitud del búfer con los datos devueltos y el miembro pData de la estructura RAW_DATA contiene la estructura WZC_802_11_CONFIG_LIST .

Si una de las redes preferidas está conectada actualmente, el miembro dwCtlFlags de la estructura WZC_WLAN_CONFIG de la red tendrá establecido el bit WZCCTL_MEDIA_CONNECTED (0x0400).

rdCtrlData

Datos binarios usados con otras marcas de control, al establecer parámetros adicionales en la interfaz.

Observaciones

La estructura INTF_ENTRY la usan las funciones WZCQueryInterface y WZCRefreshInterface .

La estructura RAW_DATA se define de la siguiente manera:

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

El miembro pData apunta a datos binarios. DwDataLen indica el número de bytes apuntados por pData.

Nota

El archivo de encabezado Wzcsapi.h no está disponible en Windows SDK.

 

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2003 [solo aplicaciones de escritorio]
Fin de compatibilidad de cliente
 Windows XP con SP3
Fin de compatibilidad de servidor
 Windows Server 2003
Encabezado
Wzcsapi.h

Vea también

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface