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

Artigo
02/27/2024

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.

O sistema operacional chama a função Dot11ExtIhvCreateDiscoveryProfiles para retornar fragmentos temporários de conectividade e perfil de segurança que poderiam ser usados para se conectar a uma rede BSS (conjunto de serviços básico) para a qual um perfil de rede não existe.

Sintaxe

DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Dot11extihvCreateDiscoveryProfiles;

DWORD Dot11extihvCreateDiscoveryProfiles(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           BOOL bInsecure,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDOT11EXT_IHV_DISCOVERY_PROFILE_LIST pIhvDiscoveryProfileList,
  [out]          PDWORD pdwReasonCode
)
{...}

Parâmetros

[in, optional] hIhvExtAdapter

O identificador usado pela DLL de Extensões IHV 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] bInsecure

Um valor booliano que especifica a status de segurança dos perfis de descoberta. Se definido como TRUE, a DLL de Extensões IHV só poderá retornar perfis seguros, como perfis que envolvem a autenticação do usuário.

[in, optional] pIhvProfileParams

Um ponteiro para um DOT11EXT_IHV_PROFILE_PARAMS estrutura. Essa estrutura define os atributos da rede BSS (conjunto de serviços básico) à qual as extensões de perfil serão aplicadas.

[in, optional] pConnectableBssid

Um ponteiro para uma estrutura DOT11_BSS_LIST , que contém um ou mais quadros 802.11 Beacon ou Probe Response recebidos de uma rede BSS. Essa lista é derivada dos resultados da última operação de verificação executada pelo adaptador WLAN. Para obter mais informações sobre a operação de verificação, consulte Operações de verificação nativas 802.11.

Nota Para o Windows Vista, a DLL de Extensões IHV dá suporte apenas a redes BSS (conjunto de serviços básicos) de infraestrutura.

[out] pIhvDiscoveryProfileList

Um ponteiro para um DOT11EXT_IHV_DISCOVERY_PROFILE_LIST estrutura que especifica uma lista de perfis de descoberta de IHV.

[out] pdwReasonCode

Um ponteiro para um valor DWORD, que fornece informações adicionais para o valor retornado da função Dot11ExtIhvCreateDiscoveryProfiles . A DLL de Extensões IHV deve definir * pdwReasonCode como um valor de L2_REASON_CODE_xxxx, que são definidos em L2cmn.h.

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

Depois que o adaptador WLAN concluir uma operação de verificação, o sistema operacional poderá chamar Dot11ExtIhvCreateDiscoveryProfiles para criar fragmentos de perfil temporários que poderiam ser usados para se conectar a uma rede BSS para a qual um perfil de rede não foi criado pelo usuário.

Quando Dot11ExtIhvCreateDiscoveryProfiles é chamado, a DLL de Extensões IHV deve seguir estas diretrizes.

Se a DLL de Extensões IHV puder retornar fragmentos de perfil que podem ser usados para se conectar à rede BSS, a função Dot11ExtIhvCreateDiscoveryProfiles deverá retornar ERROR_SUCCESS. Caso contrário, a função deverá retornar um código de erro apropriado dos valores de ERROR_xxxx definidos em Winerror.h.
A DLL de Extensões IHV fornece mais informações sobre o resultado de retorno da função Dot11ExtIhvCreateDiscoveryProfiles . A DLL deve definir * pdwReasonCode como um dos seguintes:
- L2_REASON_CODE_SUCCESS, se os fragmentos de perfil puderem ser retornados para a lista de redes BSS.
- Um valor de erro de L2_REASON_CODE_xxxx apropriado, se os fragmentos de perfil não puderem ser retornados para a lista de redes BSS.
- Um valor definido por IHV no intervalo de L2_REASON_CODE_IHV_BASE a (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), independentemente de os fragmentos de perfil serem retornados.

Para obter mais informações sobre como criar perfis de descoberta, consulte Criando extensões de perfil de rede.

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, Winclient.h, L2cmn.h)