Función WlanSetProfileEapUserData (wlanapi.h)
La función WlanSetProfileEapUserData establece las credenciales de usuario del Protocolo de autenticación extensible (EAP) según se especifica en los datos EAP sin procesar. Las credenciales de usuario se aplican a un perfil en una interfaz.
Sintaxis
DWORD WlanSetProfileEapUserData(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] LPCWSTR strProfileName,
[in] EAP_METHOD_TYPE eapType,
[in] DWORD dwFlags,
[in] DWORD dwEapUserDataSize,
[in] const LPBYTE pbEapUserData,
PVOID pReserved
);
Parámetros
[in] hClientHandle
Identificador de sesión del cliente, obtenido por una llamada anterior a la función WlanOpenHandle .
[in] pInterfaceGuid
GUID de la interfaz.
[in] strProfileName
Nombre del perfil asociado a los datos de usuario de EAP. Los nombres de perfil distinguen mayúsculas de minúsculas. Esta cadena debe terminar en NULL.
[in] eapType
Estructura EAP_METHOD_TYPE que contiene el método para el que el autor de la llamada proporciona credenciales de usuario de EAP.
[in] dwFlags
Conjunto de marcas que modifican el comportamiento de la función.
En Windows Vista y Windows Server 2008, este parámetro está reservado y debe establecerse en cero.
En Windows 7, Windows Server 2008 R2 y versiones posteriores, este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
Establezca los datos de host de EAP para todos los usuarios de este perfil. |
[in] dwEapUserDataSize
Tamaño, en bytes, de los datos a los que apunta pbEapUserData.
[in] pbEapUserData
Puntero a los datos EAP sin procesar usados para establecer las credenciales de usuario.
En Windows Vista y Windows Server 2008, este parámetro no debe ser NULL.
En Windows 7, Windows Server 2008 R2 y versiones posteriores, este parámetro se puede establecer en NULL para eliminar las credenciales almacenadas de este perfil si el parámetro dwFlags contiene WLAN_SET_EAPHOST_DATA_ALL_USERS y el parámetro dwEapUserDataSize es 0.
pReserved
Reservado para uso futuro. Debe establecerse en NULL.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.
| Código devuelto | Descripción |
|---|---|
|
Acceso denegado. Este valor se devuelve si el autor de la llamada no tiene acceso de escritura al perfil. |
|
Un parámetro es incorrecto. Este valor se devuelve si se produce alguna de las condiciones siguientes:
En Windows Vista y Windows Server 2008, este valor se devuelve si el parámetro pbEapUserData es NULL. En Windows 7, Windows Server 2008 R2 y versiones posteriores, este error se devuelve si el parámetro pbEapUserData es NULL, pero el parámetro dwEapUserDataSize no es 0 o el parámetro dwFlags no contiene WLAN_SET_EAPHOST_DATA_ALL_USERS. |
|
Un identificador no es válido. Este error se devuelve si no se encontró el identificador hClientHandle en la tabla de identificadores. |
|
No hay suficiente almacenamiento disponible para procesar este comando. |
|
No se admite la solicitud.
Este valor se devuelve cuando la configuración del perfil no permite el almacenamiento de datos de usuario. Esto puede ocurrir cuando el inicio de sesión único (SSO) está habilitado o cuando la solicitud era eliminar las credenciales almacenadas para este perfil (el parámetro pbEapUserData era NULL, el parámetro dwFlags contiene WLAN_SET_EAPHOST_DATA_ALL_USERS y el parámetro dwEapUserDataSize es 0). En Windows 10, Windows Server 2016 y versiones posteriores, este valor se devuelve si se llamó a la función WlanSetProfileEapUserData en un perfil que usa un método distinto de 802.1X para la autenticación. Este valor también se devuelve si se llamó a esta función desde un Windows XP con SP3 o LAN inalámbrica API para Windows XP con el cliente SP2. |
|
El servicio no se ha iniciado. Este valor se devuelve si el servicio LAN inalámbrico no se está ejecutando. |
|
Varios códigos de error. |
Comentarios
La función WlanSetProfileEapUserData establece las credenciales de usuario de EAP que se van a usar en un perfil. En Windows Vista y Windows Server 2008, el autor de la llamada solo puede usar estas credenciales.
El parámetro eapType es una estructura EAP_METHOD_TYPE que contiene información de tipo, identificación y autor sobre un método EAP. El miembro eapType de la estructura EAP_METHOD_TYPE es una estructura de EAP_TYPE que contiene la información de identificación del tipo y del proveedor para un método EAP.
Para obtener más información sobre la asignación de tipos de método EAP, vea la sección 6.2 de RFC 3748 publicada por IETF.
En Windows 7, Windows Server 2008 R2 y versiones posteriores, se ha mejorado la función WlanSetProfileEapUserData . Las credenciales de usuario de EAP se pueden establecer para todos los usuarios de un perfil si el parámetro dwFlags contiene WLAN_SET_EAPHOST_DATA_ALL_USERS. Las credenciales de usuario de EAP en un perfil también se pueden eliminar. Para eliminar las credenciales de usuario de EAP en un perfil, el parámetro pbEapUserData debe ser NULL, el parámetro dwFlags debe ser igual a WLAN_SET_EAPHOST_DATA_ALL_USERS y el parámetro dwEapUserDataSize debe ser 0.
Todas las funciones LAN inalámbricas requieren un GUID de interfaz para la interfaz inalámbrica al realizar operaciones de perfil. Cuando se quita una interfaz inalámbrica, su estado se borra del servicio LAN inalámbrico (WLANSVC) y no se pueden realizar operaciones de perfil.
La función WlanSetProfileEapUserData puede producir un error con ERROR_INVALID_PARAMETER si la interfaz inalámbrica especificada en el parámetro pInterfaceGuid se ha quitado del sistema (un adaptador inalámbrico USB que se ha quitado, por ejemplo).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wlanapi.h (incluya Wlanapi.h) |
| Library | Wlanapi.lib |
| Archivo DLL | Wlanapi.dll |