Provide the exception code, handle lack of message.
[vlc.git] / bindings / cil / src / exception.cs
index bf221aa..2b3118f 100644 (file)
@@ -1,11 +1,11 @@
-/*
- * libvlc.cs - libvlc-control CIL bindings
- *
- * $Id$
+/**
+ * @file exception.cs
+ * @brief LibVLC exceptions
+ * @ingroup API
  */
 
 /**********************************************************************
- *  Copyright (C) 2007 Rémi Denis-Courmont.                           *
+ *  Copyright (C) 2007-2009 Rémi Denis-Courmont.                      *
  *  This program is free software; you can redistribute and/or modify *
  *  it under the terms of the GNU General Public License as published *
  *  by the Free Software Foundation; version 2 of the license, or (at *
@@ -27,10 +27,23 @@ using System.Runtime.InteropServices;
 namespace VideoLAN.LibVLC
 {
     /**
-     * VLCException: managed base class for LibVLC exceptions
+     * @brief VLCException: base class for LibVLC exceptions
+     * @ingroup API
      */
     public class VLCException : Exception
     {
+        int code;
+        /**
+         * VLC exception code.
+         */
+        public int Code
+        {
+            get
+            {
+                return code;
+            }
+        }
+
         /**
          * Creates a managed VLC exception.
          */
@@ -56,10 +69,30 @@ namespace VideoLAN.LibVLC
            : base (message, inner)
         {
         }
+
+        /**
+         * Creates a VLC exception
+         * @param code VLC exception code
+         * @param message VLC exception message
+         */
+        public VLCException (int code, string message) : base (message)
+        {
+            this.code = code;
+        }
+
+        /**
+         * Creates a VLC exception
+         * @param code VLC exception code
+         */
+        public VLCException (int code) : base ()
+        {
+            this.code = code;
+        }
     };
 
     /**
-     * libvlc_exception_t: structure for unmanaged LibVLC exceptions
+     * @brief NativeException: CIL representation for libvlc_exception_t.
+     * @ingroup Internals
      */
     [StructLayout (LayoutKind.Sequential)]
     public sealed class NativeException : IDisposable
@@ -68,16 +101,16 @@ namespace VideoLAN.LibVLC
         int code;
         IntPtr message;
 
-        [DllImport ("libvlc-control.dll", EntryPoint="libvlc_exception_init")]
-        static extern void Init (NativeException e);
-        [DllImport ("libvlc-control.dll", EntryPoint="libvlc_exception_clear")]
-        static extern void Clear (NativeException e);
-        /*[DllImport ("libvlc-control.dll",
+        [DllImport ("libvlc.dll", EntryPoint="libvlc_exception_init")]
+        private static extern void Init (NativeException e);
+        [DllImport ("libvlc.dll", EntryPoint="libvlc_exception_clear")]
+        private static extern void Clear (NativeException e);
+        /*[DllImport ("libvlc.dll",
                     EntryPoint="libvlc_exception_raised")]
-        static extern int Raised (NativeException e);*/
-        [DllImport ("libvlc-control.dll",
+        private static extern int Raised (NativeException e);*/
+        [DllImport ("libvlc.dll",
                     EntryPoint="libvlc_exception_get_message")]
-        static extern IntPtr GetMessage (NativeException e);
+        private static extern IntPtr GetMessage (NativeException e);
 
         public NativeException ()
         {
@@ -90,11 +123,16 @@ namespace VideoLAN.LibVLC
          */
         public void Raise ()
         {
+            if (raised == 0)
+                return;
+
+            string msg = U8String.FromNative (message);
             try
             {
-                string msg = U8String.FromNative (GetMessage (this));
                 if (msg != null)
-                    throw new VLCException (msg);
+                    throw new VLCException (code, msg);
+                else
+                    throw new VLCException (code);
             }
             finally
             {