#if UNITY_EDITOR_WIN || UNITY_STANDALONE_WIN

using System;
using System.Runtime.InteropServices;

namespace Framework.Storage {

  /// <summary>Wrappers for unsafe calls to native methods</summary>
  public static class UnsafeNativeMethods {

    /// <summary>ID for the 'Saved Games' folder introduced with Windows Vista</summary>
    public static readonly Guid FOLDERID_SavedGames = new Guid(
      "4C5C32FF-BB9D-43b0-B5B4-2D72E54EAAA4"
    );
    
    /// <summary>
    ///   Retrieves the full path of a known folder identified by the folder's KNOWNFOLDERID. 
    /// </summary>
    /// <param name="knownFolderId">KNOWNFOLDERID that identifies the folder</param>
    /// <param name="flags">Special retrieval options, can be 0</param>
    /// <param name="tokenHandle">
    ///   Access token of the user or null to retrieve the folder location for the current user
    /// </param>
    /// <param name="folderPathPointer">
    ///   Receives the address of the folder path and needs to be freed by
    ///   the caller via CoTaskMemFree()
    /// </param>
    /// <returns>A HResult (negative indicates an error)</returns>
    [DllImport("shell32")]
    public static extern int SHGetKnownFolderPath(
      [MarshalAs(UnmanagedType.LPStruct)] Guid knownFolderId,
      uint flags,
      IntPtr tokenHandle,
      out IntPtr folderPathPointer // API uses CoTaskMemAlloc
    );    
    
  }

} // namespace Framework.Storage

#endif // UNITY_EDITOR_WIN || UNITY_STANDALONE_WIN