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

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.

[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.

Requisitos

Confira também

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtAllocateBuffer

DOT11EXT_IHV_PROFILE_PARAMS