WlanQueryAutoConfigParameter-Funktion (wlanapi.h)

Artikel
08/28/2023

Die WlanQueryAutoConfigParameter-Funktion fragt die Parameter des Automatischkonfigurationsdiensts ab.

Syntax

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

Parameter

[in] hClientHandle

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

[in] OpCode

Ein Wert, der den abzufragbaren Konfigurationsparameter angibt.

Wert	Bedeutung
wlan_autoconf_opcode_show_denied_networks	Wenn festgelegt, enthält der ppData-Parameter einen BOOL-Wert , der angibt, ob benutzer- und gruppenrichtlinienverwehrte Netzwerke in die Liste der verfügbaren Netzwerke aufgenommen werden. Wenn die Funktion ERROR_SUCCESS zurückgibt und ppData auf TRUE verweist, werden benutzer- und gruppenrichtlinienverwehrte Netzwerke in die Liste der verfügbaren Netzwerke aufgenommen. , wenn FALSE, Benutzer- und Gruppenrichtlinien verweigerte Netzwerke nicht in der Liste der verfügbaren Netzwerke enthalten sind.
wlan_autoconf_opcode_power_setting	Wenn festgelegt, enthält der ppData-Parameter einen WLAN_POWER_SETTING Wert, der die Energieeinstellungen angibt.
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks	Wenn festgelegt, enthält der ppData-Parameter einen BOOL-Wert , der angibt, ob nicht von der Gruppenrichtlinie erstellte Profile verwendet werden können, um eine Verbindung mit einem zulässigen Netzwerk mit einem übereinstimmenden Gruppenrichtlinienprofil herzustellen. Wenn die Funktion ERROR_SUCCESS zurückgibt und ppData auf TRUE verweist, können nur profile verwendet werden, die von der Gruppenrichtlinie erstellt wurden. wenn FALSE, kann ein beliebiges Profil verwendet werden.
wlan_autoconf_opcode_allow_explicit_creds	Wenn er festgelegt ist, enthält der ppData-Parameter einen BOOL-Wert , der angibt, ob für die aktuelle drahtlose Schnittstelle freigegebene Benutzeranmeldeinformationen zulässig sind. Wenn die Funktion ERROR_SUCCESS zurückgibt und ppData auf TRUE verweist, sind für die aktuelle drahtlose Schnittstelle freigegebene Benutzeranmeldeinformationen zulässig. wenn FALSE, lässt die aktuelle Drahtlose Schnittstelle keine freigegebenen Benutzeranmeldeinformationen zu.
wlan_autoconf_opcode_block_period	Wenn festgelegt, enthält der ppData-Parameter einen DWORD-Wert , der die Einstellung für den blockierten Zeitraum für die aktuelle drahtlose Schnittstelle angibt. Der blockierte Zeitraum ist die Zeitspanne in Sekunden, für die nach einem vorherigen Fehler keine automatische Verbindung mit einem Drahtlosen Netzwerk versucht wird.
wlan_autoconf_opcode_allow_virtual_station_extensibility	Wenn er festgelegt ist, enthält der ppData-Parameter einen BOOL-Wert , der angibt, ob die Erweiterbarkeit für eine virtuelle Station zulässig ist. Standardmäßig ist die Erweiterbarkeit für eine virtuelle Station zulässig. Der Wert für diesen Opcode wird bei Neustarts beibehalten. Wenn die Funktion ERROR_SUCCESS und ppData-Punkte auf TRUE zurückgibt, ist die Erweiterbarkeit auf einer virtuellen Station zulässig. wenn FALSE, ist die Erweiterbarkeit für eine virtuelle Station nicht zulässig.

pReserved

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

[out] pdwDataSize

Gibt die Größe des ppData-Parameters in Bytes an.

[out] ppData

Zeiger auf den Arbeitsspeicher, der den abgefragten Wert für den in OpCode angegebenen Parameter enthält.

Hinweis Wenn OpCode auf wlan_autoconf_opcode_show_denied_networks festgelegt ist, kann der von ppData referenzierte Zeiger auf einen ganzzahligen Wert verweisen. Wenn der von ppData referenzierte Zeiger auf 0 zeigt, sollte der ganzzahlige Wert in den booleschen Wert FALSE konvertiert werden. Wenn der Zeiger, auf den ppData verweist, auf eine ganze Zahl ohne Zero verweist, sollte der ganzzahlige Wert in den booleschen Wert TRUE konvertiert werden.

[out, optional] pWlanOpcodeValueType

Ein WLAN_OPCODE_VALUE_TYPE-Wert .

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	Der Aufrufer verfügt nicht über ausreichende Berechtigungen zum Abrufen von Konfigurationsparametern. Beim Aufruf von OpCode auf wlan_autoconf_opcode_show_denied_networks ruft WlanQueryAutoConfigParameter die diskretionäre Zugriffssteuerungsliste (Discretionary Access Control List, DACL) ab, die mit dem wlan_secure_show_denied-Objekt gespeichert ist. Wenn die DACL keinen Zugriffssteuerungseintrag (Access Control Entry, ACE) enthält, der WLAN_READ_ACCESS Berechtigung für das Zugriffstoken des aufrufenden Threads gewährt, gibt WlanQueryAutoConfigParameterERROR_ACCESS_DENIED zurück.
ERROR_INVALID_PARAMETER	hClientHandle ist NULL oder ungültig, pReserved ist nicht NULL, ppData ist NULL oder pdwDataSize ist NULL.
ERROR_INVALID_HANDLE	Das Handle hClientHandle wurde in der Handle-Tabelle 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-Client mit SP3 oder einer Wlan-LAN-API für Windows XP mit SP2-Client aufgerufen wurde.
RPC_STATUS	Verschiedene Fehlercodes.

Hinweise

Die WlanQueryAutoConfigParameter-Funktion fragt nach den Parametern ab, die vom Auto Configuration Module (ACM) verwendet werden und die Unter Windows Vista und höher unterstützte Drahtloskonfigurationskomponente.

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 (einschließlich Wlanapi.h)
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll

Weitere Informationen

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter

Freigeben über