DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA função de retorno de chamada (wlanihv.h)
Sintaxe
DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;
DWORD Dot11extGetProfileCustomUserData(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] HANDLE hConnectSession,
[in] DWORD dwSessionID,
[out] DWORD *pdwDataSize,
[out] LPVOID *ppvData
)
{...}
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] dwSessionID
O identificador de sessão (ID de sessão) do usuário atual.
[out] pdwDataSize
Um ponteiro para uma variável fornecida pelo chamador que armazena o tamanho, em bytes, do buffer referenciado por ppvData .
[out] ppvData
O endereço de uma variável de ponteiro que armazena o endereço do buffer que contém os dados do usuário.
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 descriptografa os dados referenciados pelo parâmetro ppvData depois de lê-los do registro do sistema. A DLL de Extensões IHV deve usar seu próprio algoritmo de descriptografia para descriptografar os dados depois de chamar Dot11ExtGetProfileCustomUserData.
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 o 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 de usuário personalizados tiverem sido definidos, esses dados poderão ser acessados usando a função Dot11ExtGetProfileCustomUserData .
O chamador é responsável por liberar a memória alocada para o buffer apontado pelo parâmetro ppvData usando a função Dot11ExtFreeBuffer .
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) |