Compartir a través de

Función WlanReasonCodeToString (wlanapi.h)

  • Artículo

La función WlanReasonCodeToString recupera una cadena que describe un código de motivo especificado.

Sintaxis

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

Parámetros

[in] dwReasonCode

Valor WLAN_REASON_CODE del que se solicita la descripción de la cadena.

[in] dwBufferSize

Tamaño del búfer usado para almacenar la cadena, en WCHAR. Si la cadena de código de motivo es mayor que el búfer, se truncará y finalizará NULL. Si dwBufferSize es mayor que la cantidad real de memoria asignada a pStringBuffer, se producirá una infracción de acceso en el programa de llamada.

[in] pStringBuffer

Puntero a un búfer que recibirá la cadena. El autor de la llamada debe asignar memoria a pStringBuffer antes de llamar a WlanReasonCodeToString.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero a una cadena constante.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Un parámetro es incorrecto. Este error se devuelve si se produce alguna de las condiciones siguientes:
  • dwBufferSize es 0.
  • pStringBuffer es NULL.
  • pReserved no es NULL.
Otros
 Varios rpc y otros códigos de error. Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wlanapi.h (incluya Wlanapi.h)
Library Wlanapi.lib
Archivo DLL Wlanapi.dll
Redistribuible API de LAN inalámbrica para Windows XP con SP2

Consulte también

WLAN_REASON_CODE