Fonction WlanGetSecuritySettings (wlanapi.h)

Article
08/28/2023

La fonction WlanGetSecuritySettings obtient les paramètres de sécurité associés à un objet configurable.

Syntaxe

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

Paramètres

[in] hClientHandle

Handle de session du client, obtenu par un appel précédent à la fonction WlanOpenHandle .

[in] SecurableObject

Valeur WLAN_SECURABLE_OBJECT qui spécifie l’objet auquel les paramètres de sécurité s’appliquent.

[out, optional] pValueType

Pointeur vers une valeur WLAN_OPCODE_VALUE_TYPE qui spécifie la source des paramètres de sécurité.

Valeur	Signification
wlan_opcode_value_type_set_by_group_policy	Les paramètres de sécurité ont été définis par la stratégie de groupe.
wlan_opcode_value_type_set_by_user	Les paramètres de sécurité ont été définis par l’utilisateur. Un utilisateur peut définir les paramètres de sécurité en appelant WlanSetSecuritySettings.

[out] pstrCurrentSDDL

Lors de l’entrée, ce paramètre doit être NULL.

Lors de la sortie, ce paramètre reçoit un pointeur vers la chaîne de descripteur de sécurité qui spécifie les paramètres de sécurité de l’objet si l’appel de fonction réussit. Pour plus d’informations sur cette chaîne, consultez Fonction WlanSetSecuritySettings .

[out] pdwGrantedAccess

Masque d’accès de l’objet.

Valeur	Signification
WLAN_READ_ACCESS	L’appelant peut afficher les autorisations de l’objet.
WLAN_EXECUTE_ACCESS	L’appelant peut lire et exécuter l’objet . WLAN_EXECUTE_ACCESS a la même valeur que la combinaison OR au niveau du bit WLAN_READ_ACCESS \| WLAN_EXECUTE_ACCESS.
WLAN_WRITE_ACCESS	L’appelant peut lire, exécuter et écrire dans l’objet . WLAN_WRITE_ACCESS a la même valeur que la combinaison OR au niveau du bit WLAN_READ_ACCESS \| WLAN_EXECUTE_ACCESS \| WLAN_WRITE_ACCESS.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour peut être l’un des codes de retour suivants.

Code de retour	Description
ERROR_INVALID_PARAMETER	Un paramètre est incorrect. Cette erreur est retournée si l’une des conditions suivantes se produit : hClientHandle a la valeur NULL. pstrCurrentSDDL a la valeur NULL. pdwGrantedAccess a la valeur NULL. SecurableObject a une valeur supérieure ou égale à WLAN_SECURABLE_OBJECT_COUNT (12).
ERROR_INVALID_HANDLE	Un handle n’est pas valide. Cette erreur est retournée si le handle spécifié dans le paramètre hClientHandle est introuvable dans la table de handle.
ERROR_ACCESS_DENIED	L’appelant ne dispose pas des autorisations suffisantes.
ERROR_NOT_SUPPORTED	Cette fonction a été appelée à partir d’une plateforme non prise en charge. Cette valeur est retournée si cette fonction a été appelée à partir d’un windows XP avec SP3 ou de l’API LAN sans fil pour Windows XP avec un client SP2.

Remarques

L’appelant est chargé de libérer la mémoire allouée à la chaîne de descripteur de sécurité pointée par le paramètre pstrCurrentSDDL si la fonction réussit. Lorsque vous n’en avez plus besoin, la mémoire de la chaîne de descripteur de sécurité doit être libérée en appelant la fonction WlanFreeMemory et en transmettant le paramètre pstrCurrentSDDL .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wlanapi.h (incluez Wlanapi.h)
Bibliothèque	Wlanapi.lib
DLL	Wlanapi.dll

Voir aussi

Autorisations de l’API Wifi native

WlanFreeMemory

WlanSetSecuritySettings

Partager via