Compartir a través de

Función WlanSetProfileList (wlanapi.h)

  • Artículo

La función WlanSetProfileList establece el orden de preferencia de los perfiles para una interfaz determinada.

Sintaxis

DWORD WlanSetProfileList(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] DWORD      dwItems,
  [in] LPCWSTR    *strProfileNames,
       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] dwItems

Número de perfiles del parámetro strProfileNames .

[in] strProfileNames

Nombres de los perfiles en el orden deseado. Los nombres de perfil distinguen mayúsculas de minúsculas. Esta cadena debe terminar en NULL.

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: Los nombres proporcionados deben coincidir con los nombres de perfil derivados automáticamente del SSID de la red. Para los perfiles de red de infraestructura, se debe proporcionar el SSID para el nombre del perfil. Para los perfiles de red ad hoc, el nombre proporcionado debe ser el SSID de la red ad hoc seguido de -adhoc.

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
ERROR_ACCESS_DENIED
 El autor de la llamada no tiene permisos suficientes para cambiar la lista de perfiles.

Antes de que WlanSetProfileList realice una operación que cambie el orden relativo de todos los perfiles de usuario en la lista de perfiles o mueva un perfil de todos los usuarios a una posición inferior en la lista de perfiles, WlanSetProfileList recupera la lista de control de acceso discrecional (DACL) almacenada con el objeto wlan_secure_all_user_profiles_order . Si la DACL no contiene una entrada de control de acceso (ACE) que concede WLAN_WRITE_ACCESS permiso al token de acceso del subproceso de llamada, WlanSetProfileList devuelve ERROR_ACCESS_DENIED.
ERROR_INVALID_HANDLE
 No se encontró el identificador hClientHandle en la tabla handle.
ERROR_INVALID_PARAMETER
 Se produjo una de las condiciones siguientes:
  • hClientHandle es NULL o no es válido.
  • pInterfaceGuid es NULL.
  • dwItems es 0.
  • strProfileNames es NULL.
  • El mismo nombre de perfil aparece más de una vez en strProfileNames.
  • pReserved no es NULL.
ERROR_NOT_FOUND
 strProfileNames contiene el nombre de un perfil que no está presente en el almacén de perfiles.
RPC_STATUS
 Varios códigos de error.

Comentarios

La función WlanSetProfileList establece el orden de preferencia de los perfiles LAN inalámbricos para una interfaz inalámbrica determinada.

Los perfiles de la lista deben ser una coincidencia uno a uno con los perfiles actuales devueltos por la función WlanGetProfileList . No se puede cambiar la posición de los perfiles de directiva de grupo.

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 WlanSetProfileList 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, Windows XP con SP3 [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
Redistribuible API de LAN inalámbrica para Windows XP con SP2

Consulte también

WlanGetProfile

WlanGetProfileList

WlanSetProfile