Funzione WlanGetSecuritySettings (wlanapi.h)

  • Articolo

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