Allow selecting/opening a source by id in case of duplicate names.

src/NTwain/DataSource.cs

@@ -103,6 +103,14 @@ namespace NTwain
 
         internal TWIdentity Identity { get; private set; }
 
+        /// <summary>
+        /// Gets the id of the source.
+        /// </summary>
+        /// <value>
+        /// The identifier.
+        /// </value>
+        public int Id { get { return Identity.Id; } }
+
         /// <summary>
         /// Gets the source's product name.
         /// </summary>

src/NTwain/IDataSource.cs

@@ -8,6 +8,14 @@ namespace NTwain
     /// </summary>
     public interface IDataSource : ITripletControl
     {
+        /// <summary>
+        /// Gets the id of the source.
+        /// </summary>
+        /// <value>
+        /// The identifier.
+        /// </value>
+        int Id { get; }
+
         /// <summary>
         /// Gets the source's product name.
         /// </summary>

src/NTwain/ITwainSession.cs

@@ -136,6 +136,13 @@ namespace NTwain
         /// <returns></returns>
         ReturnCode OpenSource(string sourceName);
 
+        /// <summary>
+        /// Quick shortcut to open a source.
+        /// </summary>
+        /// <param name="sourceId">Id of the source.</param>
+        /// <returns></returns>
+        ReturnCode OpenSource(int sourceId);
+
         /// <summary>
         /// Gets the manager status. Only call this at state 2 or higher.
         /// </summary>

src/NTwain/Properties/VersionInfo.cs

@@ -23,7 +23,7 @@ namespace NTwain
         /// <summary>
         /// The build release version number.
         /// </summary>
-        public const string Build = "3.3.2"; // change this for each nuget release
+        public const string Build = "3.3.3"; // change this for each nuget release
 
 
     }

src/NTwain/TwainSession.cs

@@ -309,6 +309,28 @@ namespace NTwain
             return ReturnCode.Failure;
         }
 
+        /// <summary>
+        /// Quick shortcut to open a source.
+        /// </summary>
+        /// <param name="sourceId">Id of the source.</param>
+        /// <returns></returns>
+        public ReturnCode OpenSource(int sourceId)
+        {
+            var curSrc = CurrentSource;
+            if (curSrc != null)
+            {
+                // TODO: close any open sources first
+
+            }
+
+            var hit = this.Where(s => s.Id == sourceId).FirstOrDefault();
+            if (hit != null)
+            {
+                return hit.Open();
+            }
+            return ReturnCode.Failure;
+        }
+
         /// <summary>
         /// Gets the manager status. Only call this at state 2 or higher.
         /// </summary>