Dot11ExtIhvInitService (Compact 2013)

  • Article

3/26/2014

The operating system calls this function to initialize the IHV Extensions DLL and the API interface between the operating system and the DLL.

Syntax

DWORD WINAPI  Dot11ExtIhvInitService(
    DWORD dwVerNumUsed,
    PDOT11EXT_APIS pDot11ExtAPI,
    LPVOID pvReserved,
    PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
);

Parameters

  • dwVerNumUsed
    [in] The interface version that is used by the operating system. The value of this parameter must be between the ranges of version numbers returned in the pDot11IHVVersionInfo parameter of the Dot11ExtIhvGetVersionInfo IHV Handler function.
  • pDot11ExtAPI
    [in] A pointer to a DOT11EXT_APIS structure. This contains the addresses of the IHV Extensibility functions that are supported by the operating system. The operating system formats this parameter with the function addresses before it makes the call to the Dot11ExtIhvInitService function.
  • pvReserved
    [in] Reserved for use by the operating system.
  • pDot11IHVHandlers
    [out] A pointer to a DOT11EXT_IHV_HANDLERS structure. This contains the addresses of the IHV Handler functions supported by the IHV Extensions DLL. The DLL formats this parameter with the function addresses before it returns from the call to the Dot11ExtIhvInitService function.

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 Dot11ExtIhvInitService function immediately after the call to the Dot11ExtIhvGetVersionInfo function. When it is called, Dot11ExtIhvInitService must initialize the IHV Extensions DLL as necessary. When the function returns, the DLL must be prepared to accept additional calls to the IHV Handler function.

Unlike other IHV Extension and Handler functions whose addresses are resolved through the pDot11IHVHandlers parameter, the operating system resolves the address of the Dot11ExtIhvInitService function by calling the GetProcAddress function. Therefore, the developer of the IHV Extensions DLL must follow these guidelines:

  • The DLL must implement a function named Dot11ExtIhvInitService, which has the format that is described in this topic.
  • The EXPORTS statement of the source module-definition (.def) file, which is used to build the IHV Extensions DLL, must contain a function name entry for the Dot11ExtIhvInitService function.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Handler Functions
Dot11ExtIhvGetVersionInfo
DOT11EXT_APIS
DOT11EXT_IHV_HANDLERS
Native 802.11 IHV Extensions DLL

Other Resources

GetProcAddress