Compartir a través de

Función WZCQueryInterface

  • Artículo

[WZCQueryInterface ya no se admite a partir de Windows Vista y Windows Server 2008. En su lugar, use la función WlanQueryInterface . Para obtener más información, consulte Acerca de la API Wifi nativa. ]

La función WZCQueryInterface proporciona información detallada sobre una interfaz LAN inalámbrica administrada por el servicio Wireless Zero Configuration.

Proporciona información detallada para una interfaz determinada.

Sintaxis

DWORD WZCQueryInterface(
  _In_    LPWSTR      pSrvAddr,
  _In_    DWORD       dwInFlags,
  _Inout_ 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 consulta el 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]

Campos que se van a consultar. Se trata de una máscara de bits que puede contener cualquier combinación de las marcas siguientes.

Valor Significado
INTF_DYNFLAGS
0x00000010
 Devuelve el valor del miembro dwDynFlags en la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
INTF_DESCR
0x00010000
 Devuelve el valor del miembro wszDescr en la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
INTF_NDISMEDIA
0x00020000
 Devuelve los valores de los miembros ulMediaState, ulMediaType y ulPhysicalMediaType de la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
INTF_PREFLIST
0x00040000
 Devuelve la lista preferida de redes en el miembro rdStSSIDList de la estructura de INTF_ENTRY a la que apunta el parámetro pIntf .
INTF_CAPABILITIES
0x00080000
 Devuelve los valores de los miembros dwCapabilities y rdNicCapabilities de la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
INTF_INFRAMODE
0x00200000
 Devuelve el valor del miembro nInfraMode de la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
El miembro nInfraMode solo es válido en algunos estados de contexto de interfaz.
INTF_AUTHMODE
0x00400000
 Devuelve el valor del miembro nAuthMode de la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
El miembro nAuthMode solo es válido en algunos estados de contexto de interfaz.
INTF_WEPSTATUS
0x00800000
 Devuelve el valor del miembro nWepStatus en la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
El miembro nWepStatus solo es válido en algunos estados de contexto de interfaz.
INTF_SSID
0x01000000
 Devuelve el valor del miembro rdSSID en la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
El miembro rdSSID solo es válido en algunos estados de contexto de interfaz.
INTF_BSSID
0x02000000
 Devuelve el valor del miembro rdBSSID en la estructura INTF_ENTRY a la que apunta el parámetro pIntf .
El miembro rdBSSID solo es válido en algunos estados de contexto de interfaz.
INTF_BSSIDLIST
0x04000000
 Devuelve la lista visible de redes en el miembro rdBSSIDList de la estructura de INTF_ENTRY a la que apunta el parámetro pIntf .
El miembro rdBSSIDList solo es válido en algunos estados de contexto de interfaz.

 

pIntf [in, out]

En la entrada, puntero a la clave de la interfaz que se va a consultar. En la salida, un puntero a los datos de interfaz solicitados. Este parámetro es un puntero a una estructura INTF_ENTRY .

pdwOutFlags [out]

Conjunto de campos recuperados 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
ERROR_ARENA_TRASHED
 Los bloques de control de almacenamiento se destruyeron. Este error se devuelve si el servicio Wireless Zero Configuration no ha inicializado objetos internos.
ERROR_FILE_NOT_FOUND
 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.
ERROR_INVALID_PARAMETER
 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.
ERROR_NOT_ENOUGH_MEMORY
 No hay suficiente memoria disponible para procesar esta solicitud y asignar memoria para los resultados de la consulta.
RPC_STATUS
 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 .

Los siguientes miembros de la estructura de INTF_ENTRY a los que apunta pIntf deben establecerse en 0 antes de una llamada a la función WZCQueryInterface : rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList y rdCtrlData.

El servicio Wireless Zero Configuration no actualiza automáticamente el estado de los medios, incluso cuando se reciben eventos conectados y desconectados de medios. Una aplicación debe forzar una actualización de estado multimedia llamando a la función WZCRefreshInterface antes de llamar a la función WZCQueryInterface si se solicita el estado multimedia NDIS (el bit INTF_NDISMEDIA se establecerá en el parámetro dwInFlags ).

Cuando el parámetro dwInFlags contiene INTF_BSSIDLIST, la función WZCQueryInterface no establece dwOutFlags con INTF_BSSIDLIST si la lista visible de redes está vacía. Cuando el parámetro dwInFlags contiene INTF_SSID, la función WZCQueryInterface no establece dwOutFlags con INTF_SSID si no hay ningún SSID disponible.

Si la función WZCQueryInterface devuelve ERROR_SUCCESS, el autor de la llamada debe llamar a la función LocalFree con el parámetro pIntf para liberar los búferes internos asignados a los datos devueltos una vez que esta información ya no sea necesaria. Esto libera los búferes utilizados por los miembros rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList y rdCtrlData de la estructura INTF_ENTRY a la que apunta el parámetro pIntf .

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
Wzcsapi.h
Biblioteca
Wzcsapi.lib
Archivo DLL
Wzcsapi.dll

Vea también

INTF_ENTRY

WZCEapolGetInterfaceParams

WZCEnumInterfaces

WZCRefreshInterface