Compartilhar via

Função WlanRegisterVirtualStationNotification (wlanapi.h)

  • Artigo

A função WlanRegisterVirtualStationNotification é usada para registrar e cancelar o registro de notificações em uma estação virtual.

Sintaxe

DWORD WlanRegisterVirtualStationNotification(
  [in] HANDLE hClientHandle,
  [in] BOOL   bRegister,
       PVOID  pReserved
);

Parâmetros

[in] hClientHandle

O identificador de sessão do cliente, obtido por uma chamada anterior para a função WlanOpenHandle .

[in] bRegister

Um valor que especifica se as notificações devem ser recebidas em uma estação virtual.

pReserved

Reservado para uso futuro. Esse parâmetro deve ser NULL.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de retorno.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um parâmetro está incorreto. Esse erro será retornado se alguma das seguintes condições ocorrer:
  • hClientHandle é NULL.
  • pvReserved não é NULL.
ERROR_INVALID_HANDLE
 Um identificador é inválido. Esse erro será retornado se o identificador especificado no parâmetro hClientHandle não tiver sido encontrado na tabela de identificador.
ERROR_INVALID_STATE
 O recurso não está no estado correto para executar a operação solicitada. Esse erro será retornado se a rede hospedada sem fio estiver desabilitada pela política de grupo em um domínio.
ERROR_SERVICE_NOT_ACTIVE
 O serviço não foi iniciado. Esse erro será retornado se o Serviço de Configuração Automática WLAN não estiver em execução.
Outras
 Vários RPC e outros códigos de erro. Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

A função WlanRegisterVirtualStationNotification é uma extensão para APIs sem fio nativas adicionadas para dar suporte à rede hospedada sem fio no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado.

Um aplicativo cliente chama a função WlanRegisterVirtualStationNotification é usada para registrar e cancelar o registro de notificações na estação virtual.

Qualquer registro para receber notificações de uma estação virtual causada por essa função será desfeito automaticamente se o aplicativo de chamada fechar seu identificador de chamada (chamando WlanCloseHandle com o parâmetro hClientHandle ) ou se o processo terminar.

Por padrão, um cliente de aplicativo não receberá notificações em uma estação virtual. Para receber essas notificações, um cliente precisa chamar a função WlanRegisterVirtualStationNotification com o parâmetro bRegister definido como TRUE e também deve chamar a função WlanRegisterNotification com o parâmetro dwNotifSource definido como fontes de notificação a serem registradas. O registro para receber notificações de uma estação virtual está em vigor até que o aplicativo feche o identificador do cliente (chamando WlanCloseHandle com o parâmetro hClientHandle ), o processo termina ou a função WlanRegisterVirtualStationNotification é chamada com o parâmetro bRegister definido como FALSE.

No Windows 7 e posteriores, o sistema operacional instalará um dispositivo virtual se um adaptador sem fio compatível com a Rede Hospedada estiver presente no computador. Esse dispositivo virtual normalmente aparece na "Pasta de Conexões de Rede" como "Conexão de Rede Sem Fio 2" com um Nome de Dispositivo de "Adaptador de Miniporto WiFi Virtual da Microsoft" se o computador tiver um único adaptador de rede sem fio. Esse dispositivo virtual é usado exclusivamente para executar conexões de ponto de acesso de software (SoftAP) e não está presente na lista retornada pela função WlanEnumInterfaces . O tempo de vida desse dispositivo virtual está vinculado ao adaptador sem fio físico. Se o adaptador sem fio físico estiver desabilitado, esse dispositivo virtual também será removido. Esse recurso também está disponível no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wlanapi.h (inclua Wlanapi.h)
Biblioteca Wlanapi.lib
DLL Wlanapi.dll

Confira também

Sobre a rede hospedada sem fio

Usando rede hospedada sem fio e compartilhamento de conexão com a Internet

WlanCloseHandle

WlanRegisterNotification