DOT11EXT_SET_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 dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.
 
El archivo DLL de extensiones IHV llama a la función Dot11ExtSetProfileCustomUserData para guardar datos en el registro del sistema que es específico del perfil de red y el usuario actual que se usa para la conexión de red del conjunto de servicios básico (BSS).

Sintaxis

DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Dot11extSetProfileCustomUserData;

DWORD Dot11extSetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [in]           DWORD dwDataSize,
  [in]           LPVOID pvData
)
{...}

Parámetros

[in, optional] hDot11SvcHandle

Identificador utilizado por el sistema operativo para hacer referencia al adaptador inalámbrico LAN (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 BSS. Este valor de identificador se especificó a través de una llamada anterior a . Dot11ExtIhvPerformPreAssociate Función IHV Handler.

[in] dwSessionID

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

[in] dwDataSize

Tamaño, en bytes, del búfer al que hace referencia pvData .

[in] pvData

Puntero a un búfer asignado por el autor de la llamada, que contiene los datos en un formato definido por el IHV.

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 cifrará los datos a los que hace referencia el parámetro pvData antes de almacenarlos en el registro del sistema. El archivo DLL de extensiones IHV debe usar su propio algoritmo de cifrado para cifrar los datos antes de llamar a Dot11ExtSetProfileCustomUserData.

Para cada perfil wlan inalámbrico utilizado 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 la 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 . Función Dot11ExtGetProfileCustomUserData . El sistema operativo almacena los datos en el registro del sistema HKEY_CURRENT_USER clave para el usuario al que hace referencia el identificador pasado en el parámetro dwSessionID .

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 (incluye Wlanihv.h)

Consulte también

Dot11ExtIhvInitAdapter

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData