WZCRefreshInterface 函数

[从 Windows Vista 和 Windows Server 2008 开始，不支持 WZCRefreshInterface 。请改用 Native Wifi API，该 API 提供类似的功能。有关详细信息，请参阅关于本机 Wifi API。]

WZCRefreshInterface 函数刷新特定无线 LAN 接口的接口信息。

语法

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	刷新无线 LAN 接口的接口说明。可以使用 dwInFlags 参数中设置的 INTF_DESCR 位调用 WZCQueryInterface 函数来检索刷新的接口说明。接口说明在 wzCQueryInterface 函数返回的 pIntf 参数指向的 INTF_ENTRY 结构的 wszDescr 成员中返回。
INTF_NDISMEDIA 0x00020000	刷新无线 LAN 接口的 NDIS 媒体信息。可以通过使用 dwInFlags 参数中设置的 INTF_NDISMEDIA 位调用 WZCQueryInterface 函数来检索刷新的 NDIS 媒体信息。 NDIS 媒体信息在 wZCQueryInterface 函数返回的 pIntf 参数指向的 INTF_ENTRY 结构的 ulMediaState、ulMediaType 和 ulPhysicalMediaType 成员中返回。
INTF_ALL_OIDS 0xFFF00000	刷新无线 LAN 接口的所有 NDIS OID。此选项刷新无线 LAN 接口的大部分数据。可以通过调用 WZCQueryInterface 函数来检索刷新的信息。

pIntf [in]

指向 INTF_ENTRY 结构的指针，该结构包含要刷新的接口的键。

pdwOutFlags [out]

已成功刷新的一组字段。

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值可能是以下返回代码之一。

返回代码	说明
ERROR_ARENA_TRASHED	存储控制块已销毁。如果无线零配置服务尚未初始化内部对象，则返回此错误。
ERROR_FILE_NOT_FOUND	系统找不到指定的文件。如果 pIntf 参数指向的 INTF_ENTRY 结构的 wszGuid 成员中的 GUID 与本地计算机上的任何无线 LAN 接口都不匹配，则返回此错误。
ERROR_INVALID_PARAMETER	参数不正确。如果 pIntf 参数为 NULL，则返回此错误。如果 pIntf 参数指向的 INTF_ENTRY 结构的 wszGuid 成员为 NULL，则返回此错误。
RPC_STATUS	各种错误代码。

pIntf 参数指向的 INTF_ENTRY 结构的 wszGuid 成员必须包含无线 LAN 接口的接口 GUID。可以通过调用 WZCEnumInterfaces 函数来检索无线 LAN 接口的列表。

注意

Wzcsapi.h 头文件和 Wzcsapi.lib 导入库文件在 Windows SDK 中不可用。