Función WZCRefreshInterface
[WZCRefreshInterface no se admite a partir de Windows Vista y Windows Server 2008. En su lugar, use la API De Wifi nativa, que proporciona una funcionalidad similar. Para obtener más información, consulte Acerca de la API de Wifi nativa.]
La función WZCRefreshInterface actualiza la información de la interfaz para una interfaz LAN inalámbrica específica.
Sintaxis
DWORD WZCRefreshInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_In_ PINTF_ENTRY pIntf,
_Out_ LPDWORD pdwOutFlags
);
Parámetros
-
pSrvAddr [in]
-
Puntero a una cadena que contiene el nombre del equipo en el que se va a ejecutar esta función. Si este parámetro es NULL, se llama al servicio Wireless Zero Configuration en el equipo local.
Si el parámetro pSrvAddr especificado es un equipo remoto, el equipo remoto debe admitir llamadas RPC remotas.
-
dwInFlags [in]
-
Conjunto de campos que se actualizarán junto con acciones de actualización específicas que se van a realizar. Se trata de una máscara de bits que puede contener cualquier combinación de las marcas siguientes.
Valor Significado - INTF_DESCR
- 0x00010000
Actualice la descripción de la interfaz para una interfaz LAN inalámbrica.
La descripción de la interfaz actualizada se puede recuperar llamando a la función WZCQueryInterface con el INTF_DESCR bit establecido en el parámetro dwInFlags . La descripción de la interfaz se devuelve en el miembro wszDescr de la estructura INTF_ENTRY a la que apunta el parámetro pIntf devuelto por la función WZCQueryInterface .- INTF_NDISMEDIA
- 0x00020000
Actualice la información multimedia de NDIS para una interfaz LAN inalámbrica.
La información multimedia NDIS actualizada se puede recuperar llamando a la función WZCQueryInterface con el INTF_NDISMEDIA bit establecido en el parámetro dwInFlags . La información multimedia de NDIS se devuelve en los miembros ulMediaState, ulMediaType y ulPhysicalMediaType de la estructura INTF_ENTRY apuntada por el parámetro pIntf devuelto por la función WZCQueryInterface .- INTF_ALL_OIDS
- 0xFFF00000
Actualice todos los NDIS OID para una interfaz LAN inalámbrica. Esta opción actualiza la mayoría de los datos de una interfaz LAN inalámbrica.
La información actualizada se puede recuperar llamando a la función WZCQueryInterface . -
pIntf [in]
-
Puntero a una estructura de INTF_ENTRY que contiene la clave de la interfaz que se va a actualizar.
-
pdwOutFlags [out]
-
Conjunto de campos que se actualizaron correctamente.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.
| Código devuelto | Descripción |
|---|---|
|
Los bloques de control de almacenamiento se destruyeron. Este error se devuelve si el servicio Wireless Zero Configuration no ha inicializado objetos internos. |
|
El sistema no encuentra el archivo especificado. Este error se devuelve si el GUID del miembro wszGuid de la estructura de INTF_ENTRY apuntado por el parámetro pIntf no coincide con ninguna de las interfaces LAN inalámbricas en el equipo local. |
|
Un parámetro es incorrecto. Este error se devuelve si el parámetro pIntf es NULL. Este error se devuelve si el miembro wszGuid de la estructura INTF_ENTRY a la que apunta el parámetro pIntf es NULL. |
|
Varios códigos de error. |
Observaciones
El miembro wszGuid de la estructura INTF_ENTRY a la que apunta el parámetro pIntf debe contener un GUID de interfaz para una interfaz LAN inalámbrica. Se puede recuperar una lista de interfaces LAN inalámbricas llamando a la función WZCEnumInterfaces .
Nota
El archivo de encabezado Wzcsapi.h y el archivo de biblioteca de importación Wzcsapi.lib no están disponibles en Windows SDK.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Fin de compatibilidad de cliente |
Windows XP con SP3 |
| Fin de compatibilidad de servidor |
Windows Server 2003 |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
Vea también