WlanGetSecuritySettings-Funktion (wlanapi.h)

  • Artikel

Die WlanGetSecuritySettings-Funktion ruft die Sicherheitseinstellungen ab, die einem konfigurierbaren Objekt zugeordnet sind.

Syntax

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

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] SecurableObject

Ein WLAN_SECURABLE_OBJECT Wert, der das Objekt angibt, für das die Sicherheitseinstellungen gelten.

[out, optional] pValueType

Ein Zeiger auf einen WLAN_OPCODE_VALUE_TYPE Wert, der die Quelle der Sicherheitseinstellungen angibt.

Wert Bedeutung
wlan_opcode_value_type_set_by_group_policy
 Die Sicherheitseinstellungen wurden durch eine Gruppenrichtlinie festgelegt.
wlan_opcode_value_type_set_by_user
 Die Sicherheitseinstellungen wurden vom Benutzer festgelegt. Ein Benutzer kann Sicherheitseinstellungen festlegen, indem er WlanSetSecuritySettings aufruft.

[out] pstrCurrentSDDL

Bei der Eingabe muss dieser Parameter NULL sein.

Bei der Ausgabe empfängt dieser Parameter einen Zeiger auf die Sicherheitsdeskriptorzeichenfolge, die die Sicherheitseinstellungen für das Objekt angibt, wenn der Funktionsaufruf erfolgreich ist. Weitere Informationen zu dieser Zeichenfolge finden Sie unter WlanSetSecuritySettings-Funktion .

[out] pdwGrantedAccess

Die Zugriffsmaske des Objekts.

Wert Bedeutung
WLAN_READ_ACCESS
 Der Aufrufer kann die Berechtigungen des Objekts anzeigen.
WLAN_EXECUTE_ACCESS
 Der Aufrufer kann aus dem -Objekt lesen und es ausführen. WLAN_EXECUTE_ACCESS hat den gleichen Wert wie die bitweise OR-Kombination WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS.
WLAN_WRITE_ACCESS
 Der Aufrufer kann aus dem -Objekt lesen, ausführen und in das -Objekt schreiben. WLAN_WRITE_ACCESS hat den gleichen Wert wie die bitweise OR-Kombination WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn eine der folgenden Bedingungen auftritt:
  • hClientHandle ist NULL.
  • pstrCurrentSDDL ist NULL.
  • pdwGrantedAccess ist NULL.
  • SecurableObject wird auf einen Wert festgelegt, der größer oder gleich WLAN_SECURABLE_OBJECT_COUNT (12) ist.
ERROR_INVALID_HANDLE
 Ein Handle ist ungültig. Dieser Fehler wird zurückgegeben, wenn das im hClientHandle-Parameter angegebene Handle in der Handletabelle nicht gefunden wurde.
ERROR_ACCESS_DENIED
 Der Aufrufer verfügt nicht über ausreichende Berechtigungen.
ERROR_NOT_SUPPORTED
 Diese Funktion wurde von einer nicht unterstützten Plattform aufgerufen. Dieser Wert wird zurückgegeben, wenn diese Funktion von einem Windows XP mit SP3 oder einer WLAN-API für Windows XP mit SP2-Client aufgerufen wurde.

Hinweise

Der Aufrufer ist dafür verantwortlich, den Arbeitsspeicher freizugeben, der der Sicherheitsdeskriptorzeichenfolge zugeordnet ist, auf die der pstrCurrentSDDL-Parameter verweist, wenn die Funktion erfolgreich ist. Wenn sie nicht mehr benötigt wird, sollte der Speicher für die Sicherheitsdeskriptorzeichenfolge freigegeben werden, indem die WlanFreeMemory-Funktion aufgerufen und der pstrCurrentSDDL-Parameter übergeben wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wlanapi.h (wlanapi.h einschließen)
Bibliothek Wlanapi.lib
DLL Wlanapi.dll

Weitere Informationen

Berechtigungen der nativen WIFI-API

WlanFreeMemory

WlanSetSecuritySettings