WlanSetAutoConfigParameter-Funktion (wlanapi.h)

  • Artikel

Die WlanSetAutoConfigParameter-Funktion legt Parameter für den automatischen Konfigurationsdienst fest.

Syntax

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

Parameter

[in] hClientHandle

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

[in] OpCode

Ein WLAN_AUTOCONF_OPCODE Wert, der den festzulegenden Parameter angibt. Nur einige der Opcodes in der WLAN_AUTOCONF_OPCODE-Enumeration unterstützen Setvorgänge.

Wert Bedeutung
wlan_autoconf_opcode_show_denied_networks
 Wenn er festgelegt ist, enthält der pData-Parameter einen BOOL-Wert , der angibt, ob Netzwerke, die von Benutzer- und Gruppenrichtlinien verweigert wurden, in die Liste der verfügbaren Netzwerke aufgenommen werden.
wlan_autoconf_opcode_allow_explicit_creds
 Wenn er festgelegt ist, enthält der pData-Parameter einen BOOL-Wert , der angibt, ob für die aktuelle drahtlose Schnittstelle freigegebene Benutzeranmeldeinformationen zulässig sind.
wlan_autoconf_opcode_block_period
 Wenn er festgelegt ist, enthält der pData-Parameter einen DWORD-Wert für die Einstellung für den blockierten Zeitraum für die aktuelle drahtlose Schnittstelle. Der Blockierte Zeitraum ist die Zeitspanne in Sekunden, für die nach einem vorherigen Fehler keine automatische Verbindung mit einem Drahtlosnetzwerk versucht wird.
wlan_autoconf_opcode_allow_virtual_station_extensibility
 Wenn er festgelegt ist, enthält der pData-Parameter einen BOOL-Wert , der angibt, ob die Erweiterbarkeit auf einer virtuellen Station zulässig ist. Standardmäßig ist die Erweiterbarkeit auf einer virtuellen Station zulässig. Der Wert für diesen Opcode wird über Neustarts hinweg beibehalten.

Dieser Enumerationswert wird unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst unterstützt.

[in] dwDataSize

Die Größe des pData-Parameters in Bytes. Dieser Parameter muss abhängig vom sizeof(BOOL) Wert des OpCode-Parameters für einen BOOL oder sizeof(DWORD) für ein DWORD auf festgelegt werden.

[in] pData

Der Wert, der für den im OpCode-Parameter angegebenen Parameter festgelegt werden soll. Der pData-Parameter muss abhängig vom Wert des OpCode-Parameters auf einen booleschen Wert oder DWORD-Wert verweisen. Der pData-Parameter darf nicht NULL sein.

Hinweis Der pData-Parameter kann auf einen ganzzahligen Wert verweisen, wenn ein boolescher Wert erforderlich ist. Wenn pData auf 0 zeigt, wird der Wert in FALSE konvertiert. Wenn pData auf eine ganze Zahl ungleich null zeigt, wird der Wert in TRUE konvertiert.
 

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

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_ACCESS_DENIED
 Zugriff verweigert.“ Dieser Fehler wird zurückgegeben, wenn der Aufrufer nicht über ausreichende Berechtigungen zum Festlegen des Konfigurationsparameters verfügt, wenn der OpCode-Parameter wlan_autoconf_opcode_show_denied_networks oder wlan_autoconf_opcode_allow_virtual_station_extensibility ist. Wenn der OpCode-Parameter auf einen dieser Werte festgelegt ist, ruft die WlanSetAutoConfigParameter-Funktion die für das opcode-Objekt gespeicherte DACL (Discretionary Access Control List) ab. Wenn die DACL keinen Zugriffssteuerungseintrag (Access Control Entry, ACE) enthält, der WLAN_WRITE_ACCESS Berechtigung für das Zugriffstoken des aufrufenden Threads gewährt, gibt WlanSetAutoConfigParameterERROR_ACCESS_DENIED zurück.

Dieser Fehler wird auch zurückgegeben, wenn der Konfigurationsparameter durch eine Gruppenrichtlinie für eine Domäne festgelegt wird. Wenn eine Gruppenrichtlinie für einen Opcode festgelegt ist, werden Anwendungen daran gehindert, Änderungen vorzunehmen. Für die folgenden OpCode-Parameter können durch Gruppenrichtlinie festgelegt werden: wlan_autoconf_opcode_show_denied_networks, wlan_autoconf_opcode_allow_explicit_creds und wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER
 Ein Parameter war ungültig. Dieser Fehler wird zurückgegeben, wenn der hClientHandle-ParameterNULL, der pData-ParameterNULL oder der pReserved-Parameter nicht NULL ist. Dieser Fehler wird auch zurückgegeben, wenn der angegebene OpCode-Parameter keiner der WLAN_AUTOCONF_OPCODE Werte für einen Konfigurationsparameter ist, der festgelegt werden kann. Dieser Fehler wird auch zurückgegeben, wenn der dwDataSize-Parameter nicht auf sizeof(BOOL)festgelegt ist oder dwDataSize nicht auf sizeof(BOOL) abhängig vom Wert des OpCode-Parameters festgelegt ist.
ERROR_INVALID_HANDLE
 Das Handle hClientHandle wurde in der Handletabelle nicht gefunden.
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.
RPC_STATUS
 Verschiedene Fehlercodes.

Hinweise

Die WlanSetAutoConfigParameter-Funktion legt Parameter fest, die vom Auto Configuration Module (ACM) verwendet werden, der unter Windows Vista und höher unterstützten Drahtlosen Konfigurationskomponente.

Abhängig vom Wert des OpCode-Parameters werden die Daten, auf die von pData verwiesen wird, in einen booleschen Wert konvertiert, bevor der parameter für die automatische Konfiguration festgelegt wird. Wenn pData auf 0 zeigt, wird der Parameter auf FALSE festgelegt. Andernfalls wird der Parameter auf TRUE festgelegt.

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

WLAN_AUTOCONF_OPCODE

WlanQueryAutoConfigParameter