DOT11EXTIHV_QUERY_UI_REQUEST función de devolución de llamada (wlanihv.h)
DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;
DWORD Dot11extihvQueryUiRequest(
[in, optional] HANDLE hIhvExtAdapter,
[in] DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
[out] PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}
[in, optional] hIhvExtAdapter
Identificador utilizado por el archivo DLL de extensiones IHV para hacer referencia al adaptador LAN inalámbrico (WLAN). Este valor de identificador se especificó a través de una llamada anterior a la función Dot11ExtIhvInitAdapter IHV Handler.
[in] connectionPhase
Fase de conexión actual. El tipo de datos de este miembro es la enumeración DOT11EXT_IHV_CONNECTION_PHASE :
Especifica cualquier fase de conexión.
Especifica la fase de conexión antes de que el archivo DLL de extensiones de IHV inicie una operación de asociación previa. Para obtener más información sobre la operación previa a la asociación, vea Operaciones previas a la asociación.
Especifica la fase de conexión después de que el archivo DLL de extensiones de IHV complete una operación posterior a la asociación. Para obtener más información sobre la operación posterior a la asociación, vea Operaciones posteriores a la asociación.
[out] ppIhvUIRequest
Dirección de un puntero a una estructura de DOT11EXT_IHV_UI_REQUEST . El archivo DLL de extensiones de IHV debe asignar un búfer para la estructura de DOT11EXT_IHV_UI_REQUEST llamando a Dot11ExtAllocateBuffer.
Si la llamada se realiza correctamente, la función devuelve ERROR_SUCCESS. De lo contrario, devuelve un código de error definido en Winerror.h.
Cuando se llama a Dot11ExtIhvQueryUIRequest , el archivo DLL de extensiones de IHV debe asignar y devolver un búfer con formato de estructura DOT11EXT_IHV_UI_REQUEST . En esta situación, el archivo DLL debe seguir estas directrices:
- El archivo DLL de extensiones de IHV debe llamar a Dot11ExtAllocateBuffer para asignar el búfer. Después de que el archivo DLL vuelva de Dot11ExtIhvQueryUIRequest, el sistema operativo es responsable de llamar a Dot11ExtFreeBuffer para liberar el búfer.
-
El archivo DLL de extensiones de IHV da formato a la estructura de DOT11EXT_IHV_UI_REQUEST para una solicitud de interfaz de usuario adecuada para el cambio en el estado de conexión.
Por ejemplo, si connectionPhase está establecido en connection_phase_initial_connection, el archivo DLL de extensiones de IHV podría establecer los miembros de la estructura de DOT11EXT_IHV_UI_REQUEST para hacer referencia a una página de interfaz de usuario que notifica al usuario el inicio de la operación de conexión.
Requisito | Value |
---|---|
Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Plataforma de destino | Escritorio |
Encabezado | wlanihv.h (incluya Wlanihv.h) |