Функция WZCRefreshInterface
[WZCRefreshInterface не поддерживается в Windows Vista и Windows Server 2008. Вместо этого используйте собственный API Wi-Fi, который предоставляет аналогичные функции. Дополнительные сведения см. в разделе Сведения об API Нативного Wi-Fi.]
Функция WZCRefreshInterface обновляет сведения об интерфейсе для определенного интерфейса беспроводной локальной сети.
Синтаксис
DWORD WZCRefreshInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_In_ PINTF_ENTRY pIntf,
_Out_ LPDWORD pdwOutFlags
);
Параметры
-
pSrvAddr [in]
-
Указатель на строку, содержащую имя компьютера, на котором выполняется эта функция. Если этот параметр имеет значение NULL, на локальном компьютере вызывается служба Беспроводной нулевой конфигурации.
Если указанный параметр pSrvAddr является удаленным компьютером, удаленный компьютер должен поддерживать удаленные вызовы RPC.
-
dwInFlags [in]
-
Набор обновляемых полей, а также определенные действия по обновлению. Это битовая маска, которая может содержать любое сочетание следующих флагов.
Значение Значение - INTF_DESCR
- 0x00010000
Обновите описание интерфейса беспроводной локальной сети.
Обновленное описание интерфейса можно получить, вызвав функцию WZCQueryInterface с INTF_DESCR битом, заданным в параметре dwInFlags . Описание интерфейса возвращается в элементе wszDescrструктуры INTF_ENTRY , на которую указывает параметр pIntf , возвращаемый функцией WZCQueryInterface .- INTF_NDISMEDIA
- 0x00020000
Обновите сведения о носителях NDIS для интерфейса беспроводной локальной сети.
Обновленные сведения о мультимедиа NDIS можно получить, вызвав функцию WZCQueryInterface с битом INTF_NDISMEDIA , заданным в параметре dwInFlags . Сведения о мультимедиа NDIS возвращаются в элементах ulMediaState, ulMediaType и ulPhysicalMediaType структуры INTF_ENTRY , на которую указывает параметр pIntf , возвращаемый функцией WZCQueryInterface .- INTF_ALL_OIDS
- 0xFFF00000
Обновите все идентификаторы NDIS для интерфейса беспроводной локальной сети. Этот параметр обновляет большую часть данных для интерфейса беспроводной локальной сети.
Обновленные сведения можно получить, вызвав функцию WZCQueryInterface . -
pIntf [in]
-
Указатель на структуру INTF_ENTRY , содержащую ключ обновляемого интерфейса.
-
pdwOutFlags [out]
-
Набор полей, которые были успешно обновлены.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.
| Код возврата | Описание |
|---|---|
|
Блоки управления хранилищем были уничтожены. Эта ошибка возвращается, если служба конфигурации беспроводной сети не инициализировала внутренние объекты. |
|
Системе не удается найти указанный файл. Эта ошибка возвращается, если GUID в элементе wszGuidструктуры INTF_ENTRY , на которую указывает параметр pIntf , не соответствует ни одному из интерфейсов беспроводной локальной сети на локальном компьютере. |
|
Неправильный параметр. Эта ошибка возвращается, если параметр pIntf имеет значение NULL. Эта ошибка возвращается, если член wszGuidструктуры INTF_ENTRY , на которую указывает параметр pIntf , имеет значение NULL. |
|
Различные коды ошибок. |
Комментарии
Член wszGuid структуры INTF_ENTRY , на которую указывает параметр pIntf , должен содержать GUID интерфейса для интерфейса беспроводной локальной сети. Список интерфейсов беспроводной локальной сети можно получить, вызвав функцию WZCEnumInterfaces .
Примечание
Файл заголовка Wzcsapi.h и файл библиотеки импорта Wzcsapi.lib недоступны в windows SDK.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| Окончание поддержки клиентов |
Windows XP с пакетом обновления 3 (SP3) |
| Окончание поддержки сервера |
Windows Server 2003 |
| Заголовок |
|
| Библиотека |
|
| DLL |
|
См. также раздел