/* Copyright (C) 2008-2016 Peter Palotas, Jeffrey Jangli, Alexandr Normuradov
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
using System;
using System.Runtime.InteropServices;
using Microsoft.Win32.SafeHandles;
namespace Alphaleonis.Win32.Security
{
/// An IntPtr wrapper which can be used as the result of a Marshal.AllocHGlobal operation.
/// Calls Marshal.FreeHGlobal when disposed or finalized.
///
internal sealed class SafeLocalMemoryBufferHandle : SafeHandleZeroOrMinusOneIsInvalid
{
#region Constructors
/// Creates new instance with zero IntPtr.
public SafeLocalMemoryBufferHandle() : base(true)
{
}
#endregion // Constructors
#region Methods
#region CopyFrom
/// Copies data from a one-dimensional, managed 8-bit unsigned integer array to the unmanaged memory pointer referenced by this instance.
/// The one-dimensional array to copy from.
/// The zero-based index into the array where Copy should start.
/// The number of array elements to copy.
public void CopyFrom(byte[] source, int startIndex, int length)
{
Marshal.Copy(source, startIndex, handle, length);
}
#endregion // CopyFrom
#region CopyTo
public void CopyTo(byte[] destination, int destinationOffset, int length)
{
if (destination == null)
throw new ArgumentNullException("destination");
if (destinationOffset < 0)
throw new ArgumentOutOfRangeException("destinationOffset", Resources.Negative_Destination_Offset);
if (length < 0)
throw new ArgumentOutOfRangeException("length", Resources.Negative_Length);
if (destinationOffset + length > destination.Length)
throw new ArgumentException(Resources.Destination_Buffer_Not_Large_Enough);
Marshal.Copy(handle, destination, destinationOffset, length);
}
#endregion // CopyTo
#region ToByteArray
public byte[] ToByteArray(int startIndex, int length)
{
if (IsInvalid)
return null;
byte[] arr = new byte[length];
Marshal.Copy(handle, arr, startIndex, length);
return arr;
}
#endregion // ToByteArray
#region ReleaseHandle
/// Called when object is disposed or finalized.
protected override bool ReleaseHandle()
{
return handle == IntPtr.Zero || NativeMethods.LocalFree(handle) == IntPtr.Zero;
}
#endregion // ReleaseHandle
#endregion // Methods
}
}