// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
#if NET
using System.Runtime.Versioning;
#endif
 
using System.Diagnostics;
using Microsoft.Win32.SafeHandles;
 
namespace Microsoft.DotNet.Cli.Utils.Extensions;
 
/// <summary>
/// Extensions methods for <see cref="Process"/> components.
/// </summary>
#if NET
[SupportedOSPlatform("windows")]
#endif
public static class ProcessExtensions
{
#pragma warning disable CA1416
    /// <summary>
    /// Returns the parent process of this process by querying the Win32_Process class.
    /// </summary>
    /// <param name="process">The process component.</param>
    /// <returns>The parent process or <see langword="null"/> if the parent process cannot be found.</returns>
    public static Process? GetParentProcess(this Process process)
    {
        int ppid = process.GetParentProcessId();
 
        return ppid != -1 ? Process.GetProcessById(ppid) : null;
    }
 
    /// <summary>
    /// Returns the parent process ID of this process by querying the Win32_Process class.
    /// </summary>
    /// <param name="process">The process component.</param>
    /// <returns>The process ID of the parent process, or -1 if the parent process could not be found.</returns>
    public static unsafe int GetParentProcessId(this Process process)
    {
        SafeProcessHandle handle = process.SafeHandle;
        NativeMethods.Windows.PROCESS_BASIC_INFORMATION info;
 
        if (NativeMethods.Windows.NtQueryInformationProcess(handle, NativeMethods.Windows.ProcessBasicInformation,
            &info, (uint)sizeof(NativeMethods.Windows.PROCESS_BASIC_INFORMATION), out _) != 0)
        {
            return -1;
        }
 
        return (int)info.InheritedFromUniqueProcessId;
    }
#pragma warning restore CA1416
}