Funzione WlanUIEditProfile (wlanapi.h)

Visualizza l'interfaccia utente del profilo wireless. Questa interfaccia utente viene usata per visualizzare e modificare le impostazioni avanzate di un profilo di rete wireless.

Sintassi

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
);

Parametri

[in] dwClientVersion

Specifica la versione più recente dell'API WLAN supportata dal client. I valori diversi da WLAN_UI_API_VERSION verranno ignorati.

[in] wstrProfileName

Contiene il nome del profilo da visualizzare o modificare. I nomi dei profili fanno distinzione tra maiuscole e minuscole. Questa stringa deve essere con terminazione NULL.

Il profilo fornito deve essere presente nell'interfaccia pInterfaceGuid. Ciò significa che il profilo deve essere stato creato e salvato in precedenza nell'archivio profili e che il profilo deve essere valido per l'interfaccia fornita.

[in] pInterfaceGuid

GUID dell'interfaccia.

[in] hWnd

Handle della finestra dell'applicazione che richiede la visualizzazione dell'interfaccia utente.

[in] wlStartPage

Valore WL_DISPLAY_PAGES che specifica la scheda attiva quando viene visualizzata la finestra di dialogo dell'interfaccia utente.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

[out] pWlanReasonCode

Puntatore a un valore WLAN_REASON_CODE che indica il motivo per cui la visualizzazione dell'interfaccia utente non è riuscita.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.

Codice restituito Descrizione
ERROR_INVALID_PARAMETER
Uno dei parametri forniti non è valido.
ERROR_NOT_SUPPORTED
Questa funzione è stata chiamata da una piattaforma non supportata. Questo valore verrà restituito se questa funzione è stata chiamata da un'API Windows XP con SP3 o LAN wireless per Windows XP con il client SP2.
RPC_STATUS
Vari codici di errore.

Commenti

Se WlanUIEditProfile restituisce ERROR_SUCCESS, tutte le modifiche apportate al profilo apportato nell'interfaccia utente verranno salvate nell'archivio profili.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wlanapi.h (include Wlanapi.h)
Libreria Wlanui.lib
DLL Wlanui.dll