Compartilhar via


estrutura INTF_ENTRY

[INTF_ENTRY não tem mais suporte a partir do Windows Vista e do Windows Server 2008. Em vez disso, use a API wi-fi nativa, que fornece funcionalidade semelhante. Para obter mais informações, consulte Sobre a API wi-fi nativa.]

Contém informações detalhadas sobre uma interface exigida por um cliente RPC.

Sintaxe

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;

Membros

wszGuid

Um ponteiro para o GUID da interface representado como uma cadeia de caracteres Unicode no seguinte formato: "{xxxxxxxx-xxxx-xxxx-xxxx-xxxx}".

wszDescr

Um ponteiro para uma cadeia de caracteres que contém a descrição da interface recuperada pelo WZCSVC (serviço de Configuração Zero Sem Fio).

dwContext

Reservado para uso interno.

ulMediaState

O estado atual de conexão de mídia NDIS para a interface. A tabela a seguir mostra os valores possíveis.

Valor Significado
MEDIA_STATE_CONNECTED
1
A mídia está conectada.
MEDIA_STATE_DISCONNECTED
0
A mídia está desconectada.
MEDIA_STATE_UNKNOWN
-1
O estado da mídia é desconhecido.

 

ulMediaType

Os tipos de mídia NDIS que a NIC usa atualmente. Quando consultado, o valor desse membro é NdisMedium802_3 conforme definido no arquivo de cabeçalho Ndispnp.h .

ulPhysicalMediaType

O tipo de mídia NDIS para a interface. Quando consultado, o valor desse membro é NdisPhysicalMediumWirelessLan , conforme definido no arquivo de cabeçalho Ndispnp.h .

nInfraMode

O modo de infraestrutura 802.11 atual definido na interface.

nAuthMode

O modo de autenticação 802.11 atual definido na interface.

A tabela a seguir mostra os valores possíveis para o parâmetro com base na enumeração NDIS_802_11_AUTHENTICATION_MODE definida no arquivo de cabeçalho NtDDNdis.h .

Valor Significado
Ndis802_11AuthModeOpen
1
IEEE 802.11 Autenticação de sistema aberto.
Ndis802_11AuthModeShared
2
Autenticação compartilhada do IEEE 802.11 que usa uma chave WEP (privacidade equivalente com fio) pré-compartilhada.
Ndis802_11AuthModeAutoSwitch
3
Modo de alternância automática. Ao usar o modo de comutador automático, a NIC (cartão interface de rede sem fio) tenta primeiro o modo de autenticação compartilhada. Se o modo compartilhado falhar, a NIC tentará usar o modo de autenticação aberta.
Ndis802_11AuthModeWPA
4
Segurança do WPA (acesso protegido sem fio). A autenticação é executada entre o servidor supplicante, autenticador e de autenticação pelo IEEE 802.1X. As chaves de criptografia são dinâmicas e derivadas por meio do processo de autenticação.
Ndis802_11AuthModeWPAPSK
5
Segurança do WPA usando uma chave pré-compartilhada. A autenticação é executada entre o supplicante e o autenticador no IEEE 802.1X. As chaves de criptografia são dinâmicas e derivadas por meio da chave pré-compartilhada usada pelo suplicante e pelo autenticador.
Ndis802_11AuthModeWPANone
6
Segurança do WPA. A autenticação é executada usando uma chave pré-compartilhada sem autenticação IEEE 802.1X. As chaves de criptografia são estáticas e derivadas por meio da chave pré-compartilhada. Esse modo é aplicável somente a tipos de rede ad hoc.
Ndis802_11AuthModeWPA2
7
Segurança do WPA2. A autenticação é executada entre o servidor supplicante, autenticador e de autenticação pelo IEEE 802.1X. As chaves de criptografia são dinâmicas e derivadas por meio do processo de autenticação.
Ndis802_11AuthModeWPA2PSK
8
Especifica a segurança do WPA2. A autenticação é executada entre o suplicante e o autenticador no IEEE 802 1X. As chaves de criptografia são dinâmicas e derivadas por meio da chave pré-compartilhada usada pelo suplicante e pelo autenticador.
Ndis802_11AuthModeMax
9
O valor máximo possível para o valor de enumeração NDIS_802_11_AUTHENTICATION_MODE. Esse não é um valor legal para o modo de autenticação.

 

nWepStatus

O modo de criptografia 802.11 atual definido na interface.

dwCtlFlags

Um valor bitmask de sinalizadores de controle que indicam como o WZCSVC está operando na interface.

A tabela a seguir mostra os valores de bit possíveis.

Valor Significado
INTFCTL_CM_MASK
0x0007
Uma máscara de bits para o modo de filtro de rede. & INTFCTL_CM_MASK dwCtlFlags resultam em um valor do tipo NDIS_802_11_NETWORK_INFRASTRUCTURE. O valor resultante indica se o WZCSVC se conecta apenas a redes de infraestrutura, redes adhoc ou a ambos os tipos de redes.
INTFCTL_ENABLED
0x8000
Indica se o WZCSVC deve configurar a interface.
INTFCTL_FALLBACK
0x4000
Se uma rede preferencial não estiver disponível, esse valor indicará se o WZCSVC deve configurar automaticamente a NIC para associar a qualquer rede disponível.
INTFCTL_OIDSSUPP
0x2000
Indica se o driver NIC dá suporte a todos os OIDs 802.11 exigidos pelo WZCSVC para funcionar.
INTFCTL_VOLATILE
0x1000
Indica se os parâmetros de serviço para essa interface devem ser retidos no registro.
Se esse valor for definido, esses parâmetros serão voláteis e não deverão ser retidos no Registro.
INTFCTL_POLICY
0x0800
Indica se os parâmetros de serviço para essa interface são enviados por push por uma política de grupo.
Se esse valor for definido, os parâmetros de serviço serão enviados por push para o computador local por política de grupo.
INTFCTL_8021XSUPP
0x1000
Indica se o suporte a 802.1X está habilitado.

 

dwDynFlags

Uma máscara de bits de sinalizadores dinâmicos que controlam o comportamento dinâmico (não persistente e não estático) na interface.

Esses bits são úteis para disparar alterações dinâmicas e temporárias na maneira como o WZCSVC atua na interface. Nenhum desses bits é persistido no Registro, portanto, as configurações não sobreviverão a uma reinicialização do sistema ou um dispositivo desabilitará e habilitará a sequência.

A tabela a seguir mostra os valores de bit possíveis.

Valor Significado
INTFDYN_NOSCAN
0x00000001
Indica que o WZCSVC não deve solicitar que a interface realize uma verificação ativa, mas usar os valores armazenados em cache no driver NIC.

 

Dwcapabilities

Especifica as funcionalidades do driver.

Valor Significado
INTFCAP_MAX_CIPHER_MASK
0x000000ff
Os bits de ordem inferior desse membro são usados para indicar a criptografia máxima com suporte. Os valores possíveis são alguns dos valores de enumeração definidos na estrutura NDIS_802_11_WEP_STATUS no arquivo de cabeçalho NtDDNdis.h incluído no SDK do Windows.
O valor de Ndis802_11Encryption1Enabled (2) indica que há suporte para WEP. Não há suporte para TKIP e AES e uma chave de transmissão pode ou não estar disponível.
O valor de Ndis802_11Encryption2Enabled (9) indica que há suporte para TKIP e WEP. Não há suporte para AES e uma chave de transmissão está disponível.
O valor de Ndis802_11Encryption3Enabled (11) indica que há suporte para AES, TKIP e WEP e uma chave de transmissão está disponível.
O Ndis802_11EncryptionNotSupported (8) indica indica que não há suporte para a chave WEP.
INTFCAP_SSN
0x00000100
Indica suporte para SSN (Simple Secure Network), que é um subconjunto de 802.11i.
O SSN altera a chave de criptografia periodicamente, em oposição ao padrão WEP (Privacidade Equivalente com Fio), que usa uma chave estática. Para que o SSN funcione, a criptografia máxima com suporte deve ser pelo menos TKIP. O SSN foi desenvolvido por um consórcio de fornecedores em 2002 como uma abordagem provisória para melhorar a segurança da LAN sem fio enquanto o padrão IEEE 802.11i estava sendo concluído.
INTFCAP_80211I
0x00000200
Indica suporte para o padrão IEEE 802.11i.

 

rdNicCapabilities

Um conjunto de recursos para 802.11i.

A função WZCQueryInterface retorna dados rdNicCapabilities quando chamado com o sinalizador INTF_CAPABILITIES passado no parâmetro dwInflags . Se a chamada de função for bem-sucedida, o membro pData da estrutura RAW_DATA conterá uma estrutura INTF_80211_CAPABILITY .

rdSSID

Dados binários que contêm o SSID 802.11 atualmente configurado na interface.

A função WZCQueryInterface retorna dados rdSSID quando chamado com o sinalizador INTF_SSID passado no parâmetro dwInflags . Se a chamada de função for bem-sucedida, o membro dwDataLen da estrutura RAW_DATA conterá o membro SsidLength de uma estrutura NDIS_802_11_SSID e o membro pData da estrutura RAW_DATA conterá o membro Ssid de uma estrutura NDIS_802_11_SSID .

A estrutura NDIS_802_11_SSID é definida no arquivo de cabeçalho Ntddndis.h .

rdBSSID

Dados binários que contêm o BSSID 802.11 configurado na interface.

A função WZCQueryInterface retorna dados rdBSSID quando chamada com o sinalizador INTF_BSSID passado no parâmetro dwInflags . Se a chamada de função for bem-sucedida, o membro dwDataLen da estrutura RAW_DATA conterá o tamanho de uma estrutura de NDIS_802_11_MAC_ADDRESS e o membro pData da estrutura RAW_DATA conterá a estrutura NDIS_802_11_MAC_ADDRESS .

A estrutura NDIS_802_11_MAC_ADDRESS é definida no arquivo de cabeçalho Ntddndis.h .

rdBSSIDList

Dados binários que contêm a lista de BSSIDs que foram recuperados pela última vez pelo WZCSVC.

A função WZCQueryInterface retorna dados rdBSSIDList quando chamada com o sinalizador INTF_BSSIDLIST passado no parâmetro dwInflags . Se a chamada de função for bem-sucedida, o membro dwDataLen da estrutura RAW_DATA conterá o comprimento do buffer com os dados retornados e o membro pData da estrutura RAW_DATA conterá a estrutura WZC_802_11_CONFIG_LIST .

rdStSSIDList

Dados binários que contêm a lista de redes preferenciais configuradas para essa interface.

A função WZCQueryInterface retorna dados rdStSSIDList quando chamado com o sinalizador INTF_PREFLIST passado no parâmetro dwInflags . Se a chamada de função for bem-sucedida, o membro dwDataLen da estrutura RAW_DATA conterá o comprimento do buffer com os dados retornados e o membro pData da estrutura RAW_DATA conterá a estrutura WZC_802_11_CONFIG_LIST .

Se uma das redes preferenciais estiver conectada no momento, o membro dwCtlFlags da estrutura WZC_WLAN_CONFIG da rede terá o bit WZCCTL_MEDIA_CONNECTED (0x0400) definido.

rdCtrlData

Dados binários usados com outros sinalizadores de controle ao definir parâmetros adicionais na interface.

Comentários

A estrutura INTF_ENTRY é usada pelas funções WZCQueryInterface e WZCRefreshInterface .

A estrutura RAW_DATA é definida da seguinte maneira:

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

O membro pData aponta para dados binários. O dwDataLen indica o número de bytes apontados pelo pData.

Observação

O arquivo de cabeçalho Wzcsapi.h não está disponível no SDK do Windows.

 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Fim do suporte ao cliente
Windows XP com SP3
Fim do suporte ao servidor
Windows Server 2003
Cabeçalho
Wzcsapi.h

Confira também

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface