DOT11EXTIHV_IS_UI_REQUEST_PENDING 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 Dot11ExtIhvIsUIRequestPending para consultar o status de uma solicitação de interface do usuário iniciada pela DLL de Extensões IHV.

Sintaxe

DOT11EXTIHV_IS_UI_REQUEST_PENDING Dot11extihvIsUiRequestPending;

DWORD Dot11extihvIsUiRequestPending(
  [in]  GUID guidUIRequest,
  [out] PBOOL pbIsRequestPending
)
{...}

Parâmetros

[in] guidUIRequest

O GUID que identifica a solicitação. Esse valor GUID foi criado pela DLL de Extensões IHV e passado pelo parâmetro pIhvUIRequest da chamada para Dot11ExtSendUIRequest.

[out] pbIsRequestPending

Um ponteiro para um valor booliano. Se a solicitação de interface do usuário, identificada pelo parâmetro guidUIRequest, estiver pendente, a DLL de Extensões IHV deverá definir * pbIsRequestPending para TRUE.

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

A DLL de Extensões IHV pode emitir solicitações para a DLL de Extensões de Interface do Usuário do IHV para interagir com o usuário. Exemplos dessas solicitações são a exibição de notificações durante a operação de pré-associação ou a entrada de credenciais para a operação pós-associação. Para obter mais informações sobre a DLL de extensões de interface do usuário IHV, consulte DLL de extensões de interface do usuário de IHV nativas 802.11.

A DLL de Extensões IHV inicia essas solicitações de interação do usuário por meio de chamadas para a função Dot11ExtSendUIRequest. Para cada solicitação de interface do usuário, a DLL deve formatar uma estrutura DOT11EXT_IHV_UI_REQUEST para definir a solicitação e deve definir o guidUIRequest membro dessa estrutura para um valor GUID que identifique exclusivamente a solicitação da interface do usuário. A DLL de Extensões IHV passa o endereço da estrutura DOT11EXT_IHV_UI_REQUEST por meio do parâmetro pIhvUIRequest da função Dot11ExtSendUIRequest.

O sistema operacional pode chamar periodicamente a função Dot11ExtIhvIsUIRequestPending para consultar o status da solicitação de interface do usuário, conforme identificado pelo parâmetro guidUIRequest. Se a solicitação de interface do usuário ainda estiver pendente, a DLL de Extensões IHV deverá definir * pbIsRequestPending para verdadeiro. Caso contrário, a DLL deve definir * pbIsRequestPending para FALSE .

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)

Consulte também

DOT11EXT_IHV_UI_REQUEST

Dot11ExtSendUIRequest

Partilhar via