Funzione WlanGetSecuritySettings (wlanapi.h)

Articolo
03/04/2024

La funzione WlanGetSecuritySettings ottiene le impostazioni di sicurezza associate a un oggetto configurabile.

Sintassi

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

Parametri

[in] hClientHandle

Handle di sessione del client ottenuto da una chiamata precedente alla funzione WlanOpenHandle .

[in] SecurableObject

Valore WLAN_SECURABLE_OBJECT che specifica l'oggetto a cui si applicano le impostazioni di sicurezza.

[out, optional] pValueType

Puntatore a un valore WLAN_OPCODE_VALUE_TYPE che specifica l'origine delle impostazioni di sicurezza.

Valore	Significato
wlan_opcode_value_type_set_by_group_policy	Le impostazioni di sicurezza sono state impostate dai criteri di gruppo.
wlan_opcode_value_type_set_by_user	Le impostazioni di sicurezza sono state impostate dall'utente. Un utente può impostare le impostazioni di sicurezza chiamando WlanSetSecuritySettings.

[out] pstrCurrentSDDL

In input, questo parametro deve essere NULL.

In output, questo parametro riceve un puntatore alla stringa del descrittore di sicurezza che specifica le impostazioni di sicurezza per l'oggetto se la chiamata di funzione ha esito positivo. Per altre informazioni su questa stringa, vedere La funzione WlanSetSecuritySettings .

[out] pdwGrantedAccess

Maschera di accesso dell'oggetto.

Valore	Significato
WLAN_READ_ACCESS	Il chiamante può visualizzare le autorizzazioni dell'oggetto.
WLAN_EXECUTE_ACCESS	Il chiamante può leggere e eseguire l'oggetto. WLAN_EXECUTE_ACCESS ha lo stesso valore della combinazione OR bit per bit WLAN_READ_ACCESS \| WLAN_EXECUTE_ACCESS.
WLAN_WRITE_ACCESS	Il chiamante può leggere, eseguire e scrivere nell'oggetto. WLAN_WRITE_ACCESS ha lo stesso valore della combinazione OR bit per bit WLAN_READ_ACCESS \| WLAN_EXECUTE_ACCESS \| WLAN_WRITE_ACCESS.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Un parametro non è corretto. Questo errore viene restituito se si verificano una delle condizioni seguenti: hClientHandle è NULL. pstrCurrentSDDL è NULL. pdwGrantedAccess è NULL. SecurableObject è impostato su un valore maggiore o uguale a WLAN_SECURABLE_OBJECT_COUNT (12).
ERROR_INVALID_HANDLE	Un handle non è valido. Questo errore viene restituito se l'handle specificato nel parametro hClientHandle non è stato trovato nella tabella handle.
ERROR_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti.
ERROR_NOT_SUPPORTED	Questa funzione è stata chiamata da una piattaforma non supportata. Questo valore verrà restituito se questa funzione è stata chiamata da un'API Windows XP con SP3 o WIRELESS LAN per Windows XP con il client SP2.

Commenti

Il chiamante è responsabile della liberazione della memoria allocata alla stringa del descrittore di sicurezza a cui punta il parametro pstrCurrentSDDL se la funzione ha esito positivo. Quando non è più necessario, la memoria per la stringa del descrittore di sicurezza deve essere liberata chiamando la funzione WlanFreeMemory e passando il parametro pstrCurrentSDDL .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wlanapi.h (include Wlanapi.h)
Libreria	Wlanapi.lib
DLL	Wlanapi.dll

Vedi anche

Autorizzazioni api Wifi native

WlanFreeMemory

WlanSetSecuritySettings

Share via