From fb9010516546a056c203b8a936502e2d234dd925 Mon Sep 17 00:00:00 2001
From: dahall <dahall@byu.net>
Date: Wed, 20 May 2020 12:25:55 -0600
Subject: [PATCH] Added SafeGuidPtr for instances where GUID is optional.

---
 Core/InteropServices/StrPtr.cs | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/Core/InteropServices/StrPtr.cs b/Core/InteropServices/StrPtr.cs
index 713b7a01..5da75913 100644
--- a/Core/InteropServices/StrPtr.cs
+++ b/Core/InteropServices/StrPtr.cs
@@ -311,4 +311,28 @@ namespace Vanara.InteropServices
 		/// <inheritdoc/>
 		public override string ToString() => Value?.ToString("B") ?? "";
 	}
+
+	/// <summary>
+	/// <para>Represents a GUID point, or REFGUID, that will automatically dispose the memory to which it points at the end of scope.</para>
+	/// <note>You must use the <see cref="Null"/> value, or the parameter-less constructor to pass the equivalent of <see langword="null"/>.</note>
+	/// </summary>
+	public class SafeGuidPtr : SafeMemStruct<Guid, CoTaskMemoryMethods>
+	{
+		/// <summary>
+		/// Initializes a new instance of the <see cref="SafeGuidPtr"/> class. This value is equivalent to a <see langword="null"/> pointer.
+		/// </summary>
+		public SafeGuidPtr() : base(IntPtr.Zero, true, 0) { }
+
+		/// <summary>Initializes a new instance of the <see cref="SafeGuidPtr"/> class.</summary>
+		/// <param name="guid">The unique identifier to assign to the pointer.</param>
+		public SafeGuidPtr(in Guid guid) : base(guid) { }
+
+		/// <summary>Performs an implicit conversion from <see cref="System.Nullable{Guid}"/> to <see cref="SafeGuidPtr"/>.</summary>
+		/// <param name="guid">The unique identifier.</param>
+		/// <returns>The resulting <see cref="SafeGuidPtr"/> instance from the conversion.</returns>
+		public static implicit operator SafeGuidPtr(Guid? guid) => guid.HasValue ? new SafeGuidPtr(guid.Value) : Null;
+
+		/// <summary>The equivalent of a <see langword="null"/> pointer to a GUID value.</summary>
+		public static readonly SafeGuidPtr Null = new SafeGuidPtr();
+	}
 }
\ No newline at end of file