WlanSetSecuritySettings-Funktion (wlanapi.h)

  • Artikel

Die WlanGetProfileList-Funktion legt die Sicherheitseinstellungen für ein konfigurierbares Objekt fest.

Syntax

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

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, auf das die Sicherheitseinstellungen angewendet werden.

[in] strModifiedSDDL

Eine Sicherheitsbeschreibungszeichenfolge, die die neuen Sicherheitseinstellungen für das -Objekt angibt. Diese Zeichenfolge muss NULL-endend sein. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

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

Ein erfolgreicher Aufruf der WlanSetSecuritySettings-Funktion überschreibt die Standardberechtigungen, die einem Objekt zugeordnet sind. Weitere Informationen zu Standardberechtigungen finden Sie unter Native Wifi-API-Berechtigungen.

Im Folgenden wird das Verfahren zum Erstellen eines Sicherheitsdeskriptorobjekts und zum Analysieren als Zeichenfolge beschrieben.

  1. Rufen Sie InitializeSecurityDescriptor auf, um einen Sicherheitsdeskriptor im Arbeitsspeicher zu erstellen.
  2. Rufen Sie SetSecurityDescriptorOwner auf, um die Besitzerinformationen für den Sicherheitsdeskriptor festzulegen.
  3. Rufen Sie InitializeAcl auf, um eine daCL (Discretionary Access Control List) im Arbeitsspeicher zu erstellen.
  4. Rufen Sie AddAccessAllowedAce oder AddAccessDeniedAce auf, um der DACL Zugriffssteuerungseinträge (ACEs) hinzuzufügen. Legen Sie den AccessMask-Parameter je nach Bedarf auf eine der folgenden bitweisen OR-Kombinationen fest:
    • WLAN_READ_ACCESS
    • WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
    • WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
  5. Rufen Sie SetSecurityDescriptorDacl auf, um die DACL zum Sicherheitsdeskriptor hinzuzufügen.
  6. Rufen Sie ConvertSecurityDescriptorToStringSecurityDescriptor auf, um den Deskriptor in eine Zeichenfolge zu konvertieren.
Die von ConvertSecurityDescriptorToStringSecurityDescriptor zurückgegebene Zeichenfolge kann dann beim Aufrufen von WlanSetSecuritySettings als strModifiedSDDL-Parameterwert verwendet werden.

Anforderungen

   
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

WlanGetSecuritySettings