Funzione WlanSetProfileCustomUserData (wlanapi.h)

Articolo
03/15/2023

La funzione WlanSetProfileCustomUserData imposta i dati utente personalizzati associati a un profilo.

Sintassi

DWORD WlanSetProfileCustomUserData(
  [in] HANDLE      hClientHandle,
  [in] const GUID  *pInterfaceGuid,
  [in] LPCWSTR     strProfileName,
  [in] DWORD       dwDataSize,
  [in] const PBYTE pData,
       PVOID       pReserved
);

Parametri

[in] hClientHandle

Handle di sessione del client, ottenuto da una chiamata precedente alla funzione WlanOpenHandle .

[in] pInterfaceGuid

GUID dell'interfaccia.

[in] strProfileName

Nome del profilo associato ai dati utente personalizzati. I nomi dei profili fanno distinzione tra maiuscole e minuscole. Questa stringa deve essere con terminazione NULL.

[in] dwDataSize

Dimensioni di pData, in byte.

[in] pData

Puntatore ai dati utente da impostare.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

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	Si è verificata una delle condizioni seguenti: hClientHandle è NULL o non valido. pInterfaceGuid è NULL. strProfileName è NULL. pReserved non è NULL. dwDataSize non è 0 e pData è NULL.
ERROR_INVALID_HANDLE	L'handle hClientHandle non è stato trovato nella tabella handle.
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

Per ogni profilo WLAN wireless utilizzato dal servizio Native Wifi AutoConfig, Windows mantiene il concetto di dati utente personalizzati. Questi dati utente personalizzati non sono inizialmente esistenti, ma possono essere impostati chiamando la funzione WlanSetProfileCustomUserData . I dati utente personalizzati vengono reimpostati su vuoti ogni volta che il profilo viene modificato chiamando la funzione WlanSetProfile .

Dopo aver impostato i dati utente personalizzati, è possibile accedere a questi dati usando la funzione WlanGetProfileCustomUserData .

Tutte le funzioni LAN wireless richiedono un GUID di interfaccia per l'interfaccia wireless durante l'esecuzione di operazioni del profilo. Quando viene rimossa un'interfaccia wireless, il relativo stato viene cancellato dal servizio LAN wireless (WLANSVC) e non è possibile eseguire alcuna operazione di profilo.

La funzione WlanSetProfileCustomUserData può avere esito negativo con ERROR_INVALID_PARAMETER se l'interfaccia wireless specificata nel parametro pInterfaceGuid è stata rimossa dal sistema (ad esempio una scheda wireless USB rimossa).

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