Funzione WlanReasonCodeToString (wlanapi.h)

  • Articolo

La funzione WlanReasonCodeToString recupera una stringa che descrive un codice motivo specificato.

Sintassi

DWORD WlanReasonCodeToString(
  [in] DWORD  dwReasonCode,
  [in] DWORD  dwBufferSize,
  [in] PWCHAR pStringBuffer,
       PVOID  pReserved
);

Parametri

[in] dwReasonCode

Valore WLAN_REASON_CODE di cui viene richiesta la descrizione della stringa.

[in] dwBufferSize

Dimensioni del buffer utilizzato per archiviare la stringa, in WCHAR. Se la stringa di codice motivo è più lunga del buffer, verrà troncata e terminata null. Se dwBufferSize è maggiore della quantità effettiva di memoria allocata a pStringBuffer, si verificherà una violazione di accesso nel programma chiamante.

[in] pStringBuffer

Puntatore a un buffer che riceverà la stringa. Il chiamante deve allocare memoria a pStringBuffer prima di chiamare WlanReasonCodeToString.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore a una stringa costante.

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

Codice restituito Descrizione
ERROR_INVALID_PARAMETER
 Un parametro non è corretto. Questo errore viene restituito se si verifica una delle condizioni seguenti:
  • dwBufferSize è 0.
  • pStringBuffer è NULL.
  • pReserved non è NULL.
Altri
 Vari codici di errore RPC e altri. Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista, Windows XP con SP3 [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
Componente ridistribuibile API LAN wireless per Windows XP con SP2

Vedi anche

WLAN_REASON_CODE