Compartilhar via

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

  • Artigo
Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte Modelo de driver universal do Windows da WLAN.
 
A DLL de Extensões IHV chama a função Dot11ExtSetCurrentProfile para especificar as configurações para os fragmentos de perfil de segurança e conectividade definidos por IHV. Esses fragmentos serão aplicados ao perfil de rede atual.

Sintaxe

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

Parâmetros

[in, optional] hDot11SvcHandle

O identificador usado pelo sistema operacional para referenciar o adaptador WLAN (LAN sem fio). Esse valor de identificador foi especificado por meio de uma chamada anterior para a função manipulador IHV Dot11ExtIhvInitAdapter .

[in, optional] hConnectSession

O identificador usado pelo sistema operacional para referenciar a sessão de conexão com a rede BSS (conjunto de serviços básico). Esse valor de identificador foi especificado por meio de uma chamada anterior para o Dot11ExtIhvPerformPreAssociate Função manipulador IHV.

[in, optional] pIhvConnProfile

Um ponteiro para um DOT11EXT_IHV_CONNECTIVITY_PROFILE estrutura que contém configurações de conectividade para o perfil IHV.

[in, optional] pIhvSecProfile

Um ponteiro para um DOT11EXT_IHV_SECURITY_PROFILE estrutura que especifica as configurações de segurança para o perfil IHV.

Retornar valor

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.

Comentários

A função Dot11ExtSetCurrentProfile permite que o IHV adicione fragmentos de perfil de segurança e conectividade personalizados ao perfil de rede atual usado para a conexão de rede BSS (conjunto de serviços básico). Os fragmentos de perfil são específicos de IHV e são aplicáveis a extensões de conectividade ou segurança disponíveis para o usuário por meio da DLL de Extensões de IHV IHV Nativas 802.11.

A DLL de Extensões IHV deve seguir estas diretrizes ao chamar a função Dot11ExtSetCurrentProfile :

  • A DLL de Extensões IHV só deve chamar Dot11ExtSetCurrentProfile ao executar uma operação de pré-associação iniciada por meio de uma chamada para o Dot11ExtIhvPerformPreAssociate Função manipulador IHV. Para obter mais informações sobre a operação de pré-associação, consulte Operação de pré-associação.
  • A DLL de Extensões IHV não deve chamar Dot11ExtSetCurrentProfile de dentro da chamada para o Dot11ExtIhvPerformPreAssociate Função manipulador IHV. Dot11ExtSetCurrentProfile deve ser chamado de um thread diferente do que está processando a chamada para Dot11ExtIhvPerformPreAssociate.

Requisitos

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

Confira também

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE