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