Angel Hernández

Extendiendo la clase Exception, recuperando mensajes de error de Win32 además de los métodos de extensión

El manejo estructurado de excepciones, es una de las características que como desarrolladores utilizamos más a menudo, ya no es necesario estar implementando etiquetas On Error u otro mecanismo poco elegante para manejar condiciones de error, sin embargo el .NET Framework es una capa entre el sistema operativo y nuestra aplicación, aunque la clase Exception describe una condición de error, carece del código de error y descripción asociado al sistema operativo, en muchas ocasiones el interpretar algunas excepciones puede llegar en cierto punto ser algo frustrante porque no es muy descriptivo, por lo que no sería mala idea recuperar la información de error emitida por Windows. Con el paso de los años, el API de Windows ha crecido y así mismo la cantidad de mensajes de error subyacentes, en el SDK de la plataforma se consigue información sobre estos mensajes de error y lo mismo sucede con el WDK, por lo que se me ocurrió la idea de extender la clase Exception a través de un método de extensión. Los métodos de extensión, nos permiten “agregar “métodos a tipos de datos existentes sin la necesidad de crear un tipo derivado, recompilar ó modificar el tipo original. Estos métodos son un tipo especial de método estático que son llamados como si fueran métodos de instancia en el tipo extendido. Su uso más común es con LINQ para así conseguir funcionalidad adicional de los tipos IEnumerable e IEnumerable<T>.

Para recuperar la descripción de un código de error utilizamos la función FormatMessage, como mostramos a continuación

[DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true,

           CallingConvention = CallingConvention.Winapi)]

public static extern int FormatMessage(int dwFlags, int lpSource, int dwMessageId,

                     int dwLanguageId, out StringBuilder lpBuffer,

                       int nSize, IntPtr va_list);

El método de extensión utilizado con la clase Exception es el siguiente

    public static class ExceptionExtension {

    /// <summary>

    /// Gets the win32 error description.

    /// </summary>

    /// <param name="ex">The ex.</param>

    /// <returns></returns>

    public static Win32Error GetWin32ErrorDescription(this Exception ex) {

        Win32Error retval = Win32Error.Empty;

        StringBuilder pMsgBuf = new StringBuilder();

        int lastError = FormatErrorHelper.GetLastError();

        FormatErrorHelper.FormatMessage(

               FormatErrorHelper.FORMAT_MESSAGE_ALLOCATE_BUFFER |

               FormatErrorHelper.FORMAT_MESSAGE_FROM_SYSTEM,

               FormatErrorHelper.NULL,   lastError, 

               FormatErrorHelper.MakeLangID(FormatErrorHelper.LANG_NEUTRAL,

               FormatErrorHelper.SUBLANG_DEFAULT), out pMsgBuf, 0, IntPtr.Zero);

         retval.ErrorCode = lastError;

         retval.Description = pMsgBuf != null ? pMsgBuf.ToString() : string.Empty;

         return retval;

      }

}

Por lo que al atrapar alguna excepción, además de obtener el objeto Exception como tal también obtengo el código y mensaje de error del sistema operativo

Win32Error osError = Win32Error.Empty;

try {

// Some funky exception here...

} catch(Exception ex) {

  osError = ex.GetWin32ErrorDescription();

  Console.WriteLine(string.Format("Code: {0} - Description: {1}", 

            new object[] {osError.ErrorCode, osError.Description}));  

}

Si ponemos en práctica todo lo mencionado anteriormente, vean lo diferente que es el mensaje de proporcionado por el .NET Framework al del sistema operativo

Espero sea de utilidad,

Saludos,

Angel