Compartilhar via


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

Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.
 
A DLL de Extensões IHV chama a função Dot11ExtSetProfileCustomUserData para salvar dados no registro do sistema específicos do usuário atual e do 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 fazer referência ao 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 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 Dot11ExtIhvPerformPreAssociate Função 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 pelo chamador, que contém os dados em um formato definido pelo 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

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 são inicialmente inexistentes, mas podem ser definidos chamando a função 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
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

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData