Fonction WlanSetSecuritySettings (wlanapi.h)

Article
08/28/2023

La fonction WlanGetProfileList définit les paramètres de sécurité d’un objet configurable.

Syntaxe

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

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é seront appliqués.

[in] strModifiedSDDL

Chaîne de descripteur de sécurité qui spécifie les nouveaux paramètres de sécurité pour l’objet . Cette chaîne doit être terminée par null. Pour plus d'informations, consultez la section Notes.

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. strModifiedSDDL 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

Un appel réussi à la fonction WlanSetSecuritySettings remplace les autorisations par défaut associées à un objet. Pour plus d’informations sur les autorisations par défaut, consultez Autorisations de l’API Wifi native.

L’article suivant décrit la procédure de création d’un objet de descripteur de sécurité et son analyse sous forme de chaîne.

Appelez InitializeSecurityDescriptor pour créer un descripteur de sécurité en mémoire.
Appelez SetSecurityDescriptorOwner pour définir les informations de propriétaire pour le descripteur de sécurité.
Appelez InitializeAcl pour créer une liste de contrôle d’accès discrétionnaire (DACL) en mémoire.
Appelez AddAccessAllowedAce ou AddAccessDeniedAce pour ajouter des entrées de contrôle d’accès (ACÉ) à la liste DACL. Définissez le paramètre AccessMask sur l’une des combinaisons OR au niveau du bit suivantes, selon le cas :
- WLAN_READ_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
Appelez SetSecurityDescriptorDacl pour ajouter le DACL au descripteur de sécurité.
Appelez ConvertSecurityDescriptorToStringSecurityDescriptor pour convertir le descripteur en chaîne.

La chaîne retournée par ConvertSecurityDescriptorToStringSecurityDescriptor peut ensuite être utilisée comme valeur de paramètre strModifiedSDDL lors de l’appel de WlanSetSecuritySettings.

Spécifications


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

WlanGetSecuritySettings

Partager via