Compartir a través de

Función WlanSetSecuritySettings (wlanapi.h)

  • Artículo

La función WlanGetProfileList establece la configuración de seguridad de un objeto configurable.

Sintaxis

DWORD WlanSetSecuritySettings(
  [in] HANDLE                hClientHandle,
  [in] WLAN_SECURABLE_OBJECT SecurableObject,
  [in] LPCWSTR               strModifiedSDDL
);

Parámetros

[in] hClientHandle

Identificador de sesión del cliente, obtenido por una llamada anterior a la función WlanOpenHandle .

[in] SecurableObject

Valor WLAN_SECURABLE_OBJECT que especifica el objeto al que se aplicará la configuración de seguridad.

[in] strModifiedSDDL

Cadena de descriptor de seguridad que especifica la nueva configuración de seguridad para el objeto . Esta cadena debe terminar en NULL. Para obtener más información, vea la sección Comentarios.

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_INVALID_PARAMETER
 Un parámetro es incorrecto. Este error se devuelve si se produce alguna de las condiciones siguientes:
  • hClientHandle es NULL.
  • strModifiedSDDL es NULL.
  • SecurableObject se establece en un valor mayor o igual que WLAN_SECURABLE_OBJECT_COUNT (12).
ERROR_INVALID_HANDLE
 Un identificador no es válido. Este error se devuelve si no se encontró el identificador especificado en el parámetro hClientHandle en la tabla de identificadores.
ERROR_ACCESS_DENIED
 El autor de la llamada no tiene permisos suficientes.
ERROR_NOT_SUPPORTED
 Se llamó a esta función desde una plataforma no admitida. Este valor se devolverá si se llamó a esta función desde un Windows XP con SP3 o la API de LAN inalámbrica para Windows XP con el cliente SP2.

Observaciones

Una llamada correcta a la función WlanSetSecuritySettings invalida los permisos predeterminados asociados a un objeto . Para obtener más información sobre los permisos predeterminados, consulte Native Wifi API Permissions.

A continuación se describe el procedimiento para crear un objeto descriptor de seguridad y analizarlo como una cadena.

  1. Llame a InitializeSecurityDescriptor para crear un descriptor de seguridad en la memoria.
  2. Llame a SetSecurityDescriptorOwner para establecer la información de propietario del descriptor de seguridad.
  3. Llame a InitializeAcl para crear una lista de control de acceso discrecional (DACL) en memoria.
  4. Llame a AddAccessAllowedAce o AddAccessDeniedAce para agregar entradas de control de acceso (ACE) a la DACL. Establezca el parámetro AccessMask en una de las siguientes combinaciones OR bit a bit según corresponda:
    • WLAN_READ_ACCESS
    • WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
    • WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
  5. Llame a SetSecurityDescriptorDacl para agregar la DACL al descriptor de seguridad.
  6. Llame a ConvertSecurityDescriptorToStringSecurityDescriptor para convertir el descriptor en cadena.
La cadena devuelta por ConvertSecurityDescriptorToStringSecurityDescriptor se puede usar como el valor del parámetro strModifiedSDDL al llamar a WlanSetSecuritySettings.

Requisitos

   
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

Consulte también

Permisos nativos de la API wifi

WlanGetSecuritySettings