Use ErrorNull instead of ErrorPostTextNull

Author: TolikPylypchuk

SharpHook.Tests/Testing/TestProviderTests.cs

@@ -565,7 +565,7 @@ public void PostTextNull()
 
         // Assert
 
-        Assert.Equal(UioHookResult.ErrorPostTextNull, actualResult);
+        Assert.Equal(UioHookResult.ErrorNull, actualResult);
         Assert.Empty(provider.PostedText);
     }
 

SharpHook.Tests/Testing/TestProviderWithEventLoopTests.cs

@@ -546,7 +546,7 @@ public void PostTextNull()
 
         // Assert
 
-        Assert.Equal(UioHookResult.ErrorPostTextNull, actualResult);
+        Assert.Equal(UioHookResult.ErrorNull, actualResult);
         Assert.Empty(provider.PostedText);
     }
 

SharpHook/Data/UioHookResult.cs

@@ -22,8 +22,16 @@ public enum UioHookResult
     ErrorOutOfMemory = 0x02,
 
     /// <summary>
-    /// A <see langword="null" /> string was passed to <see cref="UioHook.PostText(string)" />
+    /// <see langword="null" /> was passed to <see cref="UioHook.PostText(string)" /> or
+    /// <see cref="UioHook.PostEvents(UioHookEvent[], uint)"/>
     /// </summary>
+    ErrorNull = 0x03,
+
+    /// <summary>
+    /// <see langword="null" /> was passed to <see cref="UioHook.PostText(string)" /> or
+    /// <see cref="UioHook.PostEvents(UioHookEvent[], uint)"/>
+    /// </summary>
+    [Obsolete("Use ErrorNull instead")]
     ErrorPostTextNull = 0x03,
 
     /// <summary>

SharpHook/SharpHook.xml

@@ -1116,7 +1116,7 @@ UioHookResult IEventSimulationProvider.PostEvents(UioHookEvent[] events, uint si
         {
             if (events is null)
             {
-                throw new ArgumentNullException(nameof(events));
+                return UioHookResult.ErrorNull;
             }
 
             if (size > events.Length)

SharpHook/Testing/TestGlobalHook.cs

@@ -354,24 +354,24 @@ public UioHookResult PostEvent(ref UioHookEvent e)
     /// </summary>
     /// <param name="events">The events to post.</param>
     /// <param name="size">The number of events to post.</param>
-    /// <returns>The value of <see cref="PostEventResult" />.</returns>
+    /// <returns>
+    /// The value of <see cref="PostEventResult" />, or <see cref="UioHookResult.ErrorNull"/> if
+    /// <paramref name="events" /> is <see langword="null" />.
+    /// </returns>
     /// <remarks>
     /// If the provider's threading mode is <see cref="TestThreadingMode.Simple" /> then this method will immediately
     /// dispatch each event. If the threading mode is <see cref="TestThreadingMode.EventLoop" /> then the events will be
     /// posted to an event loop which runs on the same thread on which the testing hook itself runs, and then dispatched
     /// there.
     /// </remarks>
-    /// <exception cref="ArgumentNullException">
-    /// <paramref name="events" /> is <see langword="null" />.
-    /// </exception>
     /// <exception cref="ArgumentOutOfRangeException">
     /// <paramref name="size" /> is larger than length of <paramref name="events" />.
     /// </exception>
     public UioHookResult PostEvents(UioHookEvent[] events, uint size)
     {
         if (events is null)
         {
-            throw new ArgumentNullException(nameof(events));
+            return UioHookResult.ErrorNull;
         }
 
         if (size > events.Length)
@@ -397,15 +397,15 @@ public UioHookResult PostEvents(UioHookEvent[] events, uint size)
     /// </summary>
     /// <param name="text">The text to simulate.</param>
     /// <returns>
-    /// The value of <see cref="PostTextResult" />, or <see cref="UioHookResult.ErrorPostTextNull" /> if
+    /// The value of <see cref="PostTextResult" />, or <see cref="UioHookResult.ErrorNull" /> if
     /// <paramref name="text" /> is <see langword="null" />.
     /// </returns>
     /// <remarks>This method doesn't cause any input events to be created, unlike real text entry simulation.</remarks>
     public UioHookResult PostText(string text)
     {
         if (text is null)
         {
-            return UioHookResult.ErrorPostTextNull;
+            return UioHookResult.ErrorNull;
         }
 
         var result = this.PostTextResult;