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

Функция WZCQueryInterface

  • Статья

[WZCQueryInterface больше не поддерживается в Windows Vista и Windows Server 2008. Вместо этого используйте функцию WlanQueryInterface . Дополнительные сведения см. в разделе Сведения об API Нативного Wi-Fi. ]

Функция WZCQueryInterface предоставляет подробные сведения об интерфейсе беспроводной локальной сети, управляемом службой Wireless Zero Configuration.

Предоставляет подробные сведения для заданного интерфейса.

Синтаксис

DWORD WZCQueryInterface(
  _In_    LPWSTR      pSrvAddr,
  _In_    DWORD       dwInFlags,
  _Inout_ PINTF_ENTRY pIntf,
  _Out_   LPDWORD     pdwOutFlags
);

Параметры

pSrvAddr [in]

Указатель на строку, содержащую имя компьютера, на котором выполняется эта функция. Если этот параметр имеет значение NULL, на локальном компьютере запрашивается служба беспроводной нулевой конфигурации.

Если указанный параметр pSrvAddr является удаленным компьютером, удаленный компьютер должен поддерживать удаленные вызовы RPC.

dwInFlags [in]

Поля для запроса. Это битовая маска, которая может содержать любое сочетание следующих флагов.

Значение Значение
INTF_DYNFLAGS
0x00000010
 Возвращает значение элемента dwDynFlags в структуре INTF_ENTRY , на которую указывает параметр pIntf .
INTF_DESCR
0x00010000
 Возвращает значение для члена wszDescr в структуре INTF_ENTRY , на которую указывает параметр pIntf .
INTF_NDISMEDIA
0x00020000
 Возвращает значения для элементов ulMediaState, ulMediaType и ulPhysicalMediaType в структуре INTF_ENTRY , на которую указывает параметр pIntf .
INTF_PREFLIST
0x00040000
 Возвращает предпочтительный список сетей в элементе rdStSSIDListструктуры INTF_ENTRY , на которую указывает параметр pIntf .
INTF_CAPABILITIES
0x00080000
 Возвращает значения для элементов dwCapabilities и rdNicCapabilities в структуре INTF_ENTRY , на которую указывает параметр pIntf .
INTF_INFRAMODE
0x00200000
 Возвращает значение элемента nInfraMode в структуре INTF_ENTRY , на которую указывает параметр pIntf .
Член nInfraMode действителен только в некоторых состояниях контекста интерфейса.
INTF_AUTHMODE
0x00400000
 Возвращает значение элемента nAuthMode в структуре INTF_ENTRY , на которую указывает параметр pIntf .
Член nAuthMode действителен только в некоторых состояниях контекста интерфейса.
INTF_WEPSTATUS
0x00800000
 Возвращает значение элемента nWepStatus в структуре INTF_ENTRY , на которую указывает параметр pIntf .
Член nWepStatus действителен только в некоторых состояниях контекста интерфейса.
INTF_SSID
0x01000000
 Возвращает значение элемента rdSSID в структуре INTF_ENTRY , на которую указывает параметр pIntf .
Член rdSSID действителен только в некоторых состояниях контекста интерфейса.
INTF_BSSID
0x02000000
 Возвращает значение элемента rdBSSID в структуре INTF_ENTRY , на которую указывает параметр pIntf .
Член rdBSSID действителен только в некоторых состояниях контекста интерфейса.
INTF_BSSIDLIST
0x04000000
 Возвращает видимый список сетей в элементе rdBSSIDListструктуры INTF_ENTRY , на которую указывает параметр pIntf .
Член rdBSSIDList действителен только в некоторых состояниях контекста интерфейса.

 

pIntf [вход, выход]

Во входных данных — указатель на ключ интерфейса для запроса. В выходных данных — указатель на запрошенные данные интерфейса. Этот параметр является указателем на структуру INTF_ENTRY .

pdwOutFlags [out]

Набор полей успешно получен.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.

Код возврата Описание
ERROR_ARENA_TRASHED
 Блоки управления хранилищем были уничтожены. Эта ошибка возвращается, если служба беспроводной конфигурации не инициализировала внутренние объекты.
ERROR_FILE_NOT_FOUND
 Системе не удается найти указанный файл. Эта ошибка возвращается, если GUID в члене wszGuidструктуры INTF_ENTRY , на которую указывает параметр pIntf , не соответствует ни одному из интерфейсов беспроводной локальной сети на локальном компьютере.
ERROR_INVALID_PARAMETER
 Неправильный параметр. Эта ошибка возвращается, если параметр pIntf имеет значение NULL. Эта ошибка возвращается, если член wszGuidструктуры INTF_ENTRY , на который указывает параметр pIntf , имеет значение NULL.
ERROR_NOT_ENOUGH_MEMORY
 Недостаточно памяти для обработки этого запроса и выделения памяти для результатов запроса.
RPC_STATUS
 Различные коды ошибок.

 

Комментарии

Член wszGuidструктуры INTF_ENTRY , на которую указывает параметр pIntf , должен содержать GUID интерфейса для интерфейса беспроводной локальной сети. Список интерфейсов беспроводной локальной сети можно получить, вызвав функцию WZCEnumInterfaces .

Следующие элементы структуры INTF_ENTRY , на которую указывает pIntf , должны иметь значение 0 перед вызовом функции WZCQueryInterface : rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList и rdCtrlData.

Служба беспроводной нулевой конфигурации не автоматически обновляет состояние мультимедиа даже при получении событий, подключенных к носителю и отключенных. Приложение должно принудительно обновить состояние мультимедиа, вызвав функцию WZCRefreshInterface перед вызовом функции WZCQueryInterface , если запрашивается состояние мультимедиа NDIS (бит INTF_NDISMEDIA будет задан в параметре dwInFlags ).

Если параметр dwInFlags содержит INTF_BSSIDLIST, функция WZCQueryInterface не задает dwOutFlagsс INTF_BSSIDLIST если видимый список сетей пуст. Если параметр dwInFlags содержит INTF_SSID, функция WZCQueryInterface не задает dwOutFlagsс INTF_SSID , если SSID отсутствует.

Если функция WZCQueryInterface возвращает ERROR_SUCCESS, вызывающий объект должен вызвать функцию LocalFree с параметром pIntf , чтобы освободить внутренние буферы, выделенные для возвращаемых данных, когда эта информация больше не нужна. Это освобождает буферы, используемые элементами rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList и rdCtrlData структуры INTF_ENTRY , на которую указывает параметр pIntf .

Примечание

Файл заголовка Wzcsapi.h и файл библиотеки импорта Wzcsapi.lib недоступны в windows SDK.

 

Требования

Требование Значение
Минимальная версия клиента
 Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов
 Windows XP с пакетом обновления 3 (SP3)
Прекращение поддержки сервера
 Windows Server 2003
Заголовок
Wzcsapi.h
Библиотека
Wzcsapi.lib
DLL
Wzcsapi.dll

См. также раздел

INTF_ENTRY

WZCEapolGetInterfaceParams

WZCEnumInterfaces

WZCRefreshInterface