Поделиться через

структура INTF_ENTRY

  • Статья

[INTF_ENTRY больше не поддерживается в Windows Vista и Windows Server 2008. Вместо этого используйте API Native Wifi, который обеспечивает аналогичную функциональность. Дополнительные сведения см. в разделе "О api Native Wifi".]

Содержит подробные сведения об интерфейсе, который требуется клиентом RPC.

Синтаксис

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;

Участники

wszGuid

Указатель на GUID интерфейса, представленный в виде строки Юникода в следующем формате: "{xxxx-xxxx}".

wszDescr

Указатель на строку, содержащую описание интерфейса, полученное службой беспроводной нулевой конфигурации (WZCSVC).

Dwcontext

Зарезервировано для внутреннего использования.

ulMediaState

Текущее состояние подключения мультимедиа NDIS для интерфейса. В следующей таблице приводятся возможные значения.

Значение Значение
MEDIA_STATE_CONNECTED
1
 Носитель подключен.
MEDIA_STATE_DISCONNECTED
0
 Носитель отключен.
MEDIA_STATE_UNKNOWN
-1
 Состояние мультимедиа неизвестно.

 

ulMediaType

Типы носителей NDIS, которые в настоящее время использует сетевой адаптер. При запросе значение этого элемента NdisMedium802_3, как определено в файле заголовка Ndispnp.h.

ulPhysicalMediaType

Тип носителя NDIS для интерфейса. При запросе значение этого элемента — NdisPhysicalMediumWirelessLan , как определено в файле заголовка Ndispnp.h .

nInfraMode

Текущий режим инфраструктуры 802.11 в интерфейсе.

nAuthMode

Текущий режим проверки подлинности 802.11 в интерфейсе.

В следующей таблице показаны возможные значения параметра на основе перечисления NDIS_802_11_AUTHENTICATION_MODE , определенного в файле заголовка NtDDNdis.h .

Значение Значение
Ndis802_11AuthModeOpen
1
 Проверка подлинности IEEE 802.11 Open System.
Ndis802_11AuthModeShared
2
 Общая проверка подлинности IEEE 802.11, которая использует предварительно общий эквивалентный ключ конфиденциальности (WEP).
Ndis802_11AuthModeAutoSwitch
3
 Режим автоматического переключения. При использовании режима автоматического переключения интерфейс беспроводной сети карта (сетевой адаптер) сначала пытается выполнить общий режим проверки подлинности. Если общий режим завершается ошибкой, сетевой адаптер пытается использовать открытый режим проверки подлинности.
Ndis802_11AuthModeWPA
4
 Безопасность защищенного беспроводного доступа (WPA). Проверка подлинности выполняется между проверяющим, аутентификатором и сервером проверки подлинности через IEEE 802.1X. Ключи шифрования являются динамическими и являются производными с помощью процесса проверки подлинности.
Ndis802_11AuthModeWPAPSK
5
 Безопасность WPA с помощью предварительно общего ключа. Проверка подлинности выполняется между проверяющим и аутентификатором через IEEE 802.1X. Ключи шифрования являются динамическими и являются производными с помощью предварительно общего ключа, используемого проверяющим и аутентификатором.
Ndis802_11AuthModeWPANone
6
 Безопасность WPA. Проверка подлинности выполняется с помощью предварительно общего ключа без проверки подлинности IEEE 802.1X. Ключи шифрования являются статическими и являются производными с помощью предварительного ключа. Этот режим применим только к нерегламентированным типам сети.
Ndis802_11AuthModeWPA2
7
 Безопасность WPA2. Проверка подлинности выполняется между проверяющим, аутентификатором и сервером проверки подлинности через IEEE 802.1X. Ключи шифрования являются динамическими и являются производными с помощью процесса проверки подлинности.
Ndis802_11AuthModeWPA2PSK
8
 Указывает безопасность WPA2. Проверка подлинности выполняется между проверяющим и аутентификатором через IEEE 802 1X. Ключи шифрования являются динамическими и являются производными с помощью предварительно общего ключа, используемого проверяющим и аутентификатором.
Ndis802_11AuthModeMax
9
 Максимально возможное значение для значения перечисления NDIS_802_11_AUTHENTICATION_MODE . Это не юридическое значение для режима проверки подлинности.

 

nWepStatus

Текущий режим шифрования 802.11 в интерфейсе.

dwCtlFlags

Битовое значение флагов элемента управления, указывающее, как работает WZCSVC в интерфейсе.

В следующей таблице показаны возможные битовые значения.

Значение Значение
INTFCTL_CM_MASK
0x0007
 Битовая маска для режима сетевого фильтра. INTFCTL_CM_MASK и dwCtlFlags приводят к значению типа NDIS_802_11_NETWORK_INFRASTRUCTURE. Полученное значение указывает, подключается ли WZCSVC только к сетям инфраструктуры, сетям adhoc или обоим типам сетей.
INTFCTL_ENABLED
0x8000
 Указывает, должен ли WZCSVC настроить интерфейс.
INTFCTL_FALLBACK
0x4000
 Если предпочтительная сеть недоступна, это значение указывает, следует ли WZCSVC автоматически настроить сетевой адаптер для связи с любой доступной сетью.
INTFCTL_OIDSSUPP
0x2000
 Указывает, поддерживает ли драйвер сетевого адаптера все 802.11 OID, необходимые WZCSVC для работы.
INTFCTL_VOLATILE
0x1000
 Указывает, должны ли параметры службы для этого интерфейса храниться в реестре.
Если это значение задано, эти параметры являются переменными и не должны храниться в реестре.
INTFCTL_POLICY
0x0800
 Указывает, отправляются ли параметры службы для этого интерфейса групповой политикой.
Если это значение задано, параметры службы отправляются на локальный компьютер с помощью групповой политики.
INTFCTL_8021XSUPP
0x1000
 Указывает, включена ли поддержка 802.1X.

 

dwDynFlags

Битовая маска динамических флагов, управляющая динамическим поведением (нестатическое и нестатическое) в интерфейсе.

Эти биты полезны для активации динамических временных изменений таким образом, как WZCSVC действует в интерфейсе. Ни один из этих битов не сохраняется в реестре, поэтому параметры не будут сохраняться в системном перезапуске или отключении устройства и включения последовательности.

В следующей таблице показаны возможные битовые значения.

Значение Значение
INTFDYN_NOSCAN
0x00000001
 Указывает, что WZCSVC не должен запрашивать интерфейс активной проверки, а вместо этого использовать кэшированные значения в драйвере сетевого адаптера.

 

dwCapabilities

Задает возможности драйвера.

Значение Значение
INTFCAP_MAX_CIPHER_MASK
0x000000ff
 Биты нижнего порядка этого элемента используются для указания максимального поддерживаемого шифрования. Возможные значения — это некоторые значения перечисления, определенные в структуре NDIS_802_11_WEP_STATUS в файле заголовка NtDDNdis.h, включенном в пакет SDK для Windows.
Значение Ndis802_11Encryption1Enabled (2) указывает, что WEP поддерживается. TKIP и AES не поддерживаются, а ключ передачи может быть или недоступен.
Значение Ndis802_11Encryption2Enabled (9) указывает, что поддерживаются TKIP и WEP. AES не поддерживается, а ключ передачи доступен.
Значение Ndis802_11Encryption3Enabled (11) указывает, что поддерживаются AES, TKIP и WEP, а также доступен ключ передачи.
Ndis802_11EncryptionNotSupported (8) указывает, что ключ WEP не поддерживается.
INTFCAP_SSN
0x00000100
 Указывает поддержку простой безопасной сети (SSN), которая является подмножеством 802.11i.
SSN периодически изменяет ключ шифрования в отличие от стандарта WEP (проводной эквивалентной конфиденциальности), который использует статический ключ. Чтобы единый вход работал, максимальный поддерживаемый шифр должен быть по крайней мере TKIP. SSN был разработан консорциумом поставщиков в 2002 году в качестве промежуточного подхода к повышению безопасности беспроводной локальной сети в то время как стандарт IEEE 802.11i был завершен.
INTFCAP_80211I
0x00000200
 Указывает поддержку стандарта IEEE 802.11i.

 

rdNicCapabilities

Набор возможностей для 802.11i.

Функция WZCQueryInterface возвращает данные rdNicCapabilities при вызове с флагом INTF_CAPABILITIES , переданным в параметре dwInflags . Если вызов функции выполнен успешно, элемент pData структуры RAW_DATA содержит структуру INTF_80211_CAPABILITY.

rdSSID

Двоичные данные, содержащие идентификатор SSID 802.11, настроенный в данный момент в интерфейсе.

Функция WZCQueryInterface возвращает данные rdSSID при вызове с флагом INTF_SSID , переданным в параметре dwInflags . Если вызов функции выполнен успешно, элемент dwDataLen структуры RAW_DATA содержит элемент SsidLength структуры NDIS_802_11_SSID, а элемент pData структуры RAW_DATA содержит элемент Ssid структуры NDIS_802_11_SSID.

Структура NDIS_802_11_SSID определена в файле заголовка Ntddndis.h .

rdBSSID

Двоичные данные, содержащие 802.11 BSSID, настроенные в интерфейсе.

Функция WZCQueryInterface возвращает данные rdBSSID при вызове с флагом INTF_BSSID , переданным в параметре dwInflags . Если вызов функции выполнен успешно, элемент dwDataLen структуры RAW_DATA содержит размер структуры NDIS_802_11_MAC_ADDRESS, а элемент pData структуры RAW_DATA содержит структуру NDIS_802_11_MAC_ADDRESS.

Структура NDIS_802_11_MAC_ADDRESS определена в файле заголовка Ntddndis.h .

rdBSSIDList

Двоичные данные, содержащие список BSSID, которые были получены в последний раз WZCSVC.

Функция WZCQueryInterface возвращает данные rdBSSIDList при вызове с флагом INTF_BSSIDLIST , переданным в параметре dwInflags . Если вызов функции выполнен успешно, элемент dwDataLen структуры RAW_DATA содержит длину буфера с возвращаемыми данными, а элемент pData структуры RAW_DATA содержит структуру WZC_802_11_CONFIG_LIST.

rdStSSIDList

Двоичные данные, содержащие список предпочтительных сетей, настроенных для этого интерфейса.

Функция WZCQueryInterface возвращает данные rdStSSIDList при вызове с флагом INTF_PREFLIST , переданным в параметре dwInflags . Если вызов функции выполнен успешно, элемент dwDataLen структуры RAW_DATA содержит длину буфера с возвращаемыми данными, а элемент pData структуры RAW_DATA содержит структуру WZC_802_11_CONFIG_LIST.

Если одна из предпочтительных сетей в настоящее время подключена, член dwCtlFlags структуры WZC_WLAN_CONFIG сети будет иметь битовый набор WZCCTL_MEDIA_CONNECTED (0x0400).

rdCtrlData

Двоичные данные, используемые с другими флагами управления, при настройке дополнительных параметров интерфейса.

Замечания

Структура INTF_ENTRY используется функциями WZCQueryInterface и WZCRefreshInterface.

Структура RAW_DATA определяется следующим образом:

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

Член pData указывает на двоичные данные. DwDataLen указывает количество байтов, на которые указывает pData.

Примечание.

Файл заголовка Wzcsapi.h недоступен в пакете SDK для Windows.

 

Requirements

Требование Значение
Минимальная версия клиента
 Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Завершение поддержки клиентов
 Windows XP с пакетом обновления 3 (SP3)
Завершение поддержки сервера
 Windows Server 2003
Верхний колонтитул
Wzcsapi.h

См. также

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface