DOT11EXT_SET_CURRENT_PROFILE 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.

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 Dot11ExtIhvInitAdapter manipulador IHV.

[in, optional] hConnectSession

O identificador usado pelo sistema operacional para fazer referência à 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 função Dot11ExtIhvPerformPreAssociate 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.

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 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 do BSS (conjunto de serviços básico). Os fragmentos de perfil são específicos de IHV e são aplicáveis à conectividade ou às extensões de segurança disponíveis para o usuário por meio do DLL de Extensões de IHV nativas 802.11.

A DLL de Extensões IHV deve seguir estas diretrizes ao chamar a função do 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 função Dot11ExtIhvPerformPreAssociate 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 função Dot11ExtIhvPerformPreAssociate manipulador IHV. Dot11ExtSetCurrentProfile deve ser chamado de um thread diferente do que está processando a chamada para Dot11ExtIhvPerformPreAssociate.

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

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

DOT11EXT_IHV_CONNECTIVITY_PROFILE Dot11ExtIhvPerformPreAssociate

Partilhar via