DOT11EXTIHV_PROCESS_SESSION_CHANGE 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 Dot11ExtIhvProcessSessionChange para notificar a DLL de Extensões IHV de um evento de alteração de sessão.

Sintaxe

DOT11EXTIHV_PROCESS_SESSION_CHANGE Dot11extihvProcessSessionChange;

DWORD Dot11extihvProcessSessionChange(
  [in] ULONG uEventType,
  [in] PWTSSESSION_NOTIFICATION pSessionNotification
)
{...}

Parâmetros

[in] uEventType

O tipo de evento. Esse parâmetro pode ter um dos valores a seguir.

Valor	Significado
WTS_CONSOLE_CONNECT	Uma sessão foi conectada à sessão do console.
WTS_CONSOLE_DISCONNECT	Uma sessão foi desconectada da sessão do console.
WTS_REMOTE_CONNECT	Uma sessão foi conectada à sessão remota.
WTS_REMOTE_DISCONNECT	Uma sessão foi desconectada da sessão remota.
WTS_SESSION_LOGON	Um usuário fez logon na sessão.
WTS_SESSION_LOGOFF	Um usuário fez logon da sessão.
WTS_SESSION_LOCK	Uma sessão foi bloqueada.
WTS_SESSION_UNLOCK	Uma sessão foi desbloqueada.
WTS_SESSION_REMOTE_CONTROL	Uma sessão alterou seu status de controle remoto. Para determinar o status, chame a função GetSystemMetrics e verifique a métrica de SM_REMOTECONTROL. Para obter mais informações sobre essa função, consulte a documentação do SDK do Microsoft Windows.

[in] pSessionNotification

Um ponteiro para uma estrutura WTSSESSION_NOTIFICATION, que fornece informações sobre a notificação de alteração de sessão. Para obter mais informações sobre essa estrutura, consulte a documentação do SDK do Windows.

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

O sistema operacional chama a função para notificar a DLL de Extensões IHV sempre que ocorrer uma opção em uma sessão de usuário.

Se o parâmetro uEventType estiver definido como WTS_SESSION_LOGOFF, a DLL de Extensões IHV deverá cancelar todas as solicitações de interface do usuário pendentes internamente e deve liberar todos os recursos alocados para as solicitações de interface do usuário.

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)

Partilhar via