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

  • Artigo
Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte Modelo de driver universal do Windows da WLAN.
 
A DLL de Extensões IHV chama a função Dot11ExtGetProfileCustomUserData para recuperar dados do registro do sistema específicos para o usuário atual e o perfil de rede usado para a conexão de rede BSS (conjunto de serviços básico).

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)

Confira também

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile