Compartilhar via


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

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 Dot11ExtIhvValidateProfile para validar os dados do usuário inseridos para um perfil de rede. A DLL de Extensões IHV só é responsável por verificar os dados dos fragmentos do perfil de conectividade e segurança definidos pelo IHV.

Sintaxe

DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;

DWORD Dot11extihvValidateProfile(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [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, 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] pIhvConnProfile

Um ponteiro para um DOT11EXT_IHV_CONNECTIVITY_PROFILE estrutura que contém configurações de conectividade para o perfil IHV.

[in] pIhvSecProfile

Um ponteiro para um DOT11EXT_IHV_SECURITY_PROFILE estrutura que contém configurações de segurança para o perfil IHV.

[out] pdwReasonCode

Um ponteiro para um valor DWORD, que fornece informações adicionais para o valor retornado da função Dot11ExtIhvValidateProfile . 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

O sistema operacional chama a função Dot11ExtIhvValidateProfile para verificar as configurações especificadas pelo usuário para um perfil de rede antes que o perfil seja processado ou salvo.

Quando a função Dot11ExtIhvValidateProfile é chamada, a DLL de Extensões IHV segue estas diretrizes:

  • A DLL de Extensões IHV verifica se as configurações de perfil especificadas pelo usuário são válidas para os atributos gerais da rede BSS (conjunto de serviços básico) à qual o perfil será aplicado. Os atributos de rede BSS são referenciados por meio do parâmetro pIhvProfileParams .
  • Se os dados do usuário forem válidos para as extensões de perfil de rede, Dot11ExtIhvValidateProfile 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 os resultados da validação dos dados do usuário. A DLL deve definir * pdwReasonCode como um dos seguintes:
    • L2_REASON_CODE_SUCCESS, se os dados do usuário forem válidos.
    • Um valor de erro de L2_REASON_CODE_xxxx apropriado, se os dados do usuário não forem válidos.
    • 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 da validade dos dados do usuário.
Para obter mais informações sobre o esquema XML do Native 802.11, consulte a documentação do SDK do Microsoft Windows.

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

Confira também

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE