Función WlanGetSecuritySettings (wlanapi.h)

La función WlanGetSecuritySettings obtiene la configuración de seguridad asociada a un objeto configurable.

Sintaxis

DWORD WlanGetSecuritySettings(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_SECURABLE_OBJECT   SecurableObject,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pValueType,
  [out]           LPWSTR                  *pstrCurrentSDDL,
  [out]           PDWORD                  pdwGrantedAccess
);

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 aplica la configuración de seguridad.

[out, optional] pValueType

Puntero a un valor de WLAN_OPCODE_VALUE_TYPE que especifica el origen de la configuración de seguridad.

Valor	Significado
wlan_opcode_value_type_set_by_group_policy	La configuración de seguridad se estableció mediante la directiva de grupo.
wlan_opcode_value_type_set_by_user	El usuario estableció la configuración de seguridad. Un usuario puede establecer la configuración de seguridad llamando a WlanSetSecuritySettings.

[out] pstrCurrentSDDL

En la entrada, este parámetro debe ser NULL.

En la salida, este parámetro recibe un puntero a la cadena del descriptor de seguridad que especifica la configuración de seguridad para el objeto si la llamada de función se realiza correctamente. Para obtener más información sobre esta cadena, consulta Función WlanSetSecuritySettings .

[out] pdwGrantedAccess

Máscara de acceso del objeto .

Valor	Significado
WLAN_READ_ACCESS	El autor de la llamada puede ver los permisos del objeto.
WLAN_EXECUTE_ACCESS	El autor de la llamada puede leer y ejecutar el objeto . WLAN_EXECUTE_ACCESS tiene el mismo valor que la combinación OR bit a bit WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS.
WLAN_WRITE_ACCESS	El autor de la llamada puede leer, ejecutar y escribir en el objeto . WLAN_WRITE_ACCESS tiene el mismo valor que la combinación OR bit a bit WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS.

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. pstrCurrentSDDL es NULL. pdwGrantedAccess 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 handle.
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 LAN inalámbrica API para Windows XP con el cliente SP2.

Comentarios

El autor de la llamada es responsable de liberar la memoria asignada a la cadena del descriptor de seguridad a la que apunta el parámetro pstrCurrentSDDL si la función se realiza correctamente. Cuando ya no sea necesario, la memoria de la cadena del descriptor de seguridad debe liberarse llamando a la función WlanFreeMemory y pasando el parámetro pstrCurrentSDDL .

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

Consulte también

Permisos nativos de la API de Wifi

WlanFreeMemory

WlanSetSecuritySettings