DOT11EXTIHV_QUERY_UI_REQUEST função de retorno de chamada (wlanihv.h)

Artigo
02/07/2025

Importante A interface de lan sem fio do Nativo 802.11 é preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte do modelo de driver Universal do Windows da WLAN.

O sistema operacional chama a função Dot11ExtIhvQueryUIRequest sempre que o status da conexão for alterado. Quando essa função é chamada, a DLL de Extensões IHV retorna uma estrutura DOT11EXT_IHV_UI_REQUEST que o sistema operacional pode usar para uma solicitação de interface do usuário.

Sintaxe

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

Parâmetros

[in, optional] hIhvExtAdapter

O identificador usado pela DLL de Extensões IHV para referenciar o adaptador WLAN (LAN sem fio). Esse valor de identificador foi especificado por meio de uma chamada anterior para a função Dot11ExtIhvInitAdapter manipulador IHV.

[in] connectionPhase

A fase de conexão atual. O tipo de dados desse membro é a enumeração DOT11EXT_IHV_CONNECTION_PHASE:

connection_phase_any

Especifica qualquer fase de conexão.

connection_phase_initial_connection

Especifica a fase de conexão antes que a DLL de Extensões IHV inicie uma operação de pré-associação. Para obter mais informações sobre a operação de pré-associação, consulte operações de pré-associação.

connection_phase_post_l3_connection

Especifica a fase de conexão após a DLL de Extensões IHV concluir uma operação pós-associação. Para obter mais informações sobre a operação pós-associação, consulte operações pós-associação.

[out] ppIhvUIRequest

O endereço de um ponteiro para uma estrutura DOT11EXT_IHV_UI_REQUEST. A DLL de Extensões IHV deve alocar um buffer para a estrutura de DOT11EXT_IHV_UI_REQUEST chamando Dot11ExtAllocateBuffer.

Valor de retorno

Se a chamada for bem-sucedida, a função retornará ERROR_SUCCESS. Caso contrário, ele retornará um código de erro definido em Winerror.h.

Observações

Quando Dot11ExtIhvQueryUIRequest é chamada, a DLL de Extensões IHV deve alocar e retornar um buffer formatado como uma estrutura de DOT11EXT_IHV_UI_REQUEST. Nessa situação, a DLL deve seguir estas diretrizes:

A DLL de Extensões IHV deve chamar Dot11ExtAllocateBuffer para alocar o buffer. Depois que a DLL retorna de Dot11ExtIhvQueryUIRequest, o sistema operacional é responsável por chamar Dot11ExtFreeBuffer para liberar o buffer.
A DLL de Extensões IHV formata a estrutura DOT11EXT_IHV_UI_REQUEST para uma solicitação de interface do usuário apropriada para a alteração no status da conexão.
Por exemplo, se connectionPhase for definido como connection_phase_initial_connection, a DLL de Extensões IHV poderá definir os membros da estrutura DOT11EXT_IHV_UI_REQUEST para fazer referência a uma página de interface do usuário que notifica o usuário do início da operação de conexão.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	wlanihv.h (inclua Wlanihv.h)