Compartir a través de

DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA función de devolución de llamada (wlanihv.h)

  • Artículo
Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.
 
El archivo DLL de extensiones de IHV llama a la función Dot11ExtGetProfileCustomUserData para recuperar datos del registro del sistema específicos del perfil de red y del usuario actual que se usa para la conexión de red del conjunto de servicios básico (BSS).

Sintaxis

DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;

DWORD Dot11extGetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [out]          DWORD *pdwDataSize,
  [out]          LPVOID *ppvData
)
{...}

Parámetros

[in, optional] hDot11SvcHandle

Identificador utilizado por el sistema operativo para hacer referencia al adaptador LAN inalámbrico (WLAN). Este valor de identificador se especificó a través de una llamada anterior a la función Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] hConnectSession

Identificador utilizado por el sistema operativo para hacer referencia a la sesión de conexión con la red básica del conjunto de servicios (BSS). Este valor de identificador se especificó a través de una llamada anterior a . Dot11ExtIhvPerformPreAssociate Función de controlador de IHV.

[in] dwSessionID

Identificador de sesión (id. de sesión) del usuario actual.

[out] pdwDataSize

Puntero a una variable proporcionada por el autor de la llamada que almacena el tamaño, en bytes, del búfer al que hace referencia ppvData .

[out] ppvData

Dirección de una variable de puntero que almacena la dirección del búfer que contiene los datos del usuario.

Valor devuelto

Si la llamada se realiza correctamente, la función devuelve ERROR_SUCCESS. De lo contrario, devuelve un código de error definido en Winerror.h.

Comentarios

El sistema operativo no descifra los datos a los que hace referencia el parámetro ppvData después de leerlos del registro del sistema. El archivo DLL de extensiones de IHV debe usar su propio algoritmo de descifrado para descifrar los datos después de llamar a Dot11ExtGetProfileCustomUserData.

Para cada perfil inalámbrico WLAN usado por el servicio Native Wifi AutoConfig, Windows mantiene el concepto de datos de usuario personalizados. Estos datos de usuario personalizados no existen inicialmente, pero se pueden establecer llamando a . Función Dot11ExtSetProfileCustomUserData . Los datos de usuario personalizados se restablecen a vacíos cada vez que se modifica el perfil mediante una llamada a . Función Dot11ExtSetCurrentProfile .

Una vez establecidos los datos de usuario personalizados, se puede acceder a estos datos mediante la función Dot11ExtGetProfileCustomUserData .

El autor de la llamada es responsable de liberar la memoria asignada para el búfer al que apunta el parámetro ppvData mediante la función Dot11ExtFreeBuffer .

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado wlanihv.h (incluya Wlanihv.h)

Consulte también

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile