DOT11EXT_SET_CURRENT_PROFILE função de retorno de chamada (wlanihv.h)
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) |