Compartilhar via

Dot11ExtGetProfileCustomUserData (Compact 2013)

  • Artigo

3/26/2014

The IHV Extensions DLL calls this function to retrieve data from the system registry that is specific to the current user and network profile used for the basic service set (BSS) network connection.

Syntax

DWORD WINAPI Dot11ExtGetProfileCustomUserData(
    HANDLE hDot11SvcHandle,
    HANDLE  hConnectSession,
    DWORD  dwSessionID,
    DWORD* pdwDataSize,
    LPVOID* ppvData
);

Parameters

  • hDot11SvcHandle
    [in] The handle that is used by the operating system to reference the wireless LAN (WLAN) adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.
  • hConnectSession
    [in] The handle that is used by the operating system to reference the connection session with the basic service set (BSS) network. This handle value was specified through a previous call to the Dot11ExtIhvPerformPreAssociate IHV Handler function.
  • dwSessionID
    [in] The session identifier (session ID) of the current user.
  • pdwDataSize
    [out] A pointer to a caller-supplied variable that stores the size, in bytes, of the buffer referenced by ppvData.
  • ppvData
    [out] The address of a pointer variable that stores the address of the buffer that contains the user data.

Return Value

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

Remarks

When it calls Dot11ExtGetProfileCustomUserData, the IHV Extensions DLL must follow these guidelines:

  • The IHV Extensions DLL must call Dot11ExtSetCurrentProfile only when it is performing a pre-association operation that was initiated through a call to the Dot11ExtIhvPerformPreAssociate IHV Handler function.
  • The IHV Extensions DLL must not call Dot11ExtSetCurrentProfile from inside the call to the Dot11ExtIhvPerformPreAssociate IHV Handler function. Dot11ExtSetCurrentProfile must be called from a different thread than the one which is processing the call to Dot11ExtIhvPerformPreAssociate.
  • The operating system does not decrypt the data referenced by the ppvData parameter after it reads it from the system registry. The IHV Extensions DLL should use its own decryption algorithm to decrypt the data after it calls Dot11ExtGetProfileCustomUserData.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvInitAdapter
Dot11ExtIhvPerformPreAssociate
Dot11ExtSetCurrentProfile
Native 802.11 IHV Extensions DLL