WlanUIEditProfile-Funktion (wlanapi.h)

Artikel
03/04/2024

Zeigt die Benutzeroberfläche des Drahtlosprofils an. Diese Benutzeroberfläche wird verwendet, um erweiterte Einstellungen eines Drahtlosnetzwerkprofils anzuzeigen und zu bearbeiten.

Syntax

DWORD WlanUIEditProfile(
  [in]  DWORD             dwClientVersion,
  [in]  LPCWSTR           wstrProfileName,
  [in]  GUID              *pInterfaceGuid,
  [in]  HWND              hWnd,
  [in]  WL_DISPLAY_PAGES  wlStartPage,
        PVOID             pReserved,
  [out] PWLAN_REASON_CODE pWlanReasonCode
);

Parameter

[in] dwClientVersion

Gibt die höchste Version der WLAN-API an, die vom Client unterstützt wird. Andere Werte als WLAN_UI_API_VERSION werden ignoriert.

[in] wstrProfileName

Enthält den Namen des anzuzeigenden oder zu bearbeitenden Profils. Bei Profilnamen wird die Groß-/Kleinschreibung beachtet. Diese Zeichenfolge muss NULL-endend sein.

Das angegebene Profil muss auf der Schnittstelle pInterfaceGuid vorhanden sein. Das bedeutet, dass das Profil zuvor erstellt und im Profilspeicher gespeichert worden sein muss und dass das Profil für die angegebene Schnittstelle gültig sein muss.

[in] pInterfaceGuid

Die GUID der Schnittstelle.

[in] hWnd

Das Handle des Anwendungsfensters, das die Anzeige der Benutzeroberfläche anfordert.

[in] wlStartPage

Ein WL_DISPLAY_PAGES Wert, der die aktive Registerkarte angibt, wenn das Dialogfeld ui angezeigt wird.

pReserved

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

[out] pWlanReasonCode

Ein Zeiger auf einen WLAN_REASON_CODE Wert, der angibt, warum die Anzeige der Benutzeroberfläche fehlgeschlagen ist.

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	Einer der angegebenen Parameter ist ungültig.
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

Wenn WlanUIEditProfile ERROR_SUCCESS zurückgibt, werden alle auf der Benutzeroberfläche vorgenommenen Änderungen am Profil im Profilspeicher gespeichert.

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	Wlanui.lib
DLL	Wlanui.dll

Freigeben über