DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA 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 Dot11ExtSetProfileCustomUserData para salvar dados no registro do sistema específicos ao usuário atual e ao perfil de rede usado para a conexão de rede do BSS (conjunto de serviços básico).

Sintaxe

DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Dot11extSetProfileCustomUserData;

DWORD Dot11extSetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [in]           DWORD dwDataSize,
  [in]           LPVOID pvData
)
{...}

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. Esse valor de identificador foi especificado por meio de uma chamada anterior para o função Dot11ExtIhvPerformPreAssociate manipulador IHV.

[in] dwSessionID

O identificador de sessão (ID da sessão) do usuário atual.

[in] dwDataSize

O tamanho, em bytes, do buffer referenciado por pvData .

[in] pvData

Um ponteiro para um buffer alocado por chamador, que contém os dados em um formato definido pelo 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

O sistema operacional não criptografará os dados referenciados pelo parâmetro pvData antes de armazená-los no registro do sistema. A DLL de Extensões IHV deve usar seu próprio algoritmo de criptografia para criptografar os dados antes de chamar Dot11ExtSetProfileCustomUserData.

Para cada perfil WLAN sem fio usado pelo serviço de Configuração Automática De Wi-Fi Nativo, o Windows mantém o conceito de dados de usuário personalizados. Esses dados de usuário personalizados inicialmente não existem, mas podem ser definidos chamando a função do Dot11ExtSetProfileCustomUserData. Os dados personalizados do usuário são redefinidos para vazios sempre que o perfil é modificado chamando o função Dot11ExtSetCurrentProfile.

Depois que os dados personalizados do usuário tiverem sido definidos, esses dados poderão ser acessados usando o função Dot11ExtGetProfileCustomUserData. O sistema operacional armazena os dados no registro do sistema HKEY_CURRENT_USER chave para o usuário referenciado pelo identificador passado no parâmetro dwSessionID.

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

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData

Compartilhar via