// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
 
#nullable disable
 
using System;
using System.Runtime.InteropServices;
using Microsoft.VisualStudio.Shell.Interop;
 
namespace Microsoft.VisualStudio.LanguageServices.Implementation.ProjectSystem.Interop;
 
/// <remarks>
/// A redefinition of Microsoft.VisualStudio.Shell.Interop.IVsInvisibleEditorManager. One critical difference
/// here is we declare the ppEditor retval argument as IntPtr instead of IVsInvisibleEditor. Since the
/// invisible editor is saved and closed when the last reference is Released(), it's critical we have precise
/// control when the COM object goes away. By default, the COM marshaller will return a non-unique RCW, which
/// means we have no control over when the RCW will call Release(). To have control, we need a unique RCW, but
/// the only way we can (correctly) get this is if we have the native IntPtr right from the start.
/// </remarks>
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("14439CDE-B6CF-4DD6-9615-67E8B3DF380D")]
internal interface IIntPtrReturningVsInvisibleEditorManager
{
    int RegisterInvisibleEditor(
        [MarshalAs(UnmanagedType.LPWStr)] string pszMkDocument,
        IVsProject pProject,
        uint dwFlags,
        IVsSimpleDocFactory pFactory,
        out IntPtr ppEditor);
}