Partager via

Dot11ExtIhvValidateProfile (Compact 2013)

  • Article

3/26/2014

The operating system calls this function to validate user data that is entered for a network profile. The IHV Extensions DLL is responsible for verifying the data for the fragments of the connectivity and security profile defined by the IHV.

Syntax

DWORD WINAPI Dot11ExtIhvValidateProfile(
    HANDLE hIhvExtAdapter,
    PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
    PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
    PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
    PDWORD pdwReasonCode
);

Parameters

  • hIhvExtAdapter
    [in] The handle that is used by the IHV Extensions DLL to reference the WLAN adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.
  • pIhvProfileParams
    [in] A pointer to a DOT11EXT_IHV_PROFILE_PARAMS structure. This structure defines the attributes of the basic service set (BSS) network to which the profile extensions will be applied.
  • pwdReasonCode
    [out] A pointer to a DWORD value, which provides additional information for the return value of the Dot11ExtIhvValidateProfile function. The IHV Extensions DLL must set *pdwReasonCode to an L2_REASON_CODE_xxxx value, which are defined in L2cmn.h.

Return Value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.

Remarks

The operating system calls the Dot11ExtIhvValidateProfile function to verify the user-specified settings for a network profile before the profile is processed or saved.

When the Dot11ExtIhvValidateProfile function is called, the IHV Extensions DLL follows these guidelines:

  • The IHV Extensions DLL verifies that the user-specified profile settings are valid for the general attributes of the basic service set (BSS) network to which the profile will be applied. The BSS network attributes are referenced through the pIhvProfileParams parameter.
  • If the user data is valid for the network profile extensions, Dot11ExtIhvValidateProfile must return ERROR_SUCCESS. Otherwise, the function must return an appropriate error code from the ERROR_xxxx values that are defined in Winerror.h.
  • The IHV Extensions DLL provides more information about the results of the validation of the user data. The DLL must set *pdwReasonCode to one of the following:
    • L2_REASON_CODE_SUCCESS, if the user data is valid
    • An appropriate L2_REASON_CODE_xxxx error value, if the user data is not valid
    • An IHV-defined value in the range from L2_REASON_CODE_IHV_BASE to (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), regardless of the validity of the user data

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Handler Functions
Dot11ExtIhvInitAdapter
DOT11EXT_IHV_PROFILE_PARAMS
DOT11EXT_IHV_CONNECTIVITY_PROFILE
DOT11EXT_IHV_SECURITY_PROFILE
Native 802.11 IHV Extensions DLL