Vanara/PInvoke/Shared/WinBase/SECURITY_ATTRIBUTES.cs

62 lines
3.3 KiB
C#

using System;
using System.Runtime.InteropServices;
namespace Vanara.PInvoke
{
/// <summary>
/// The SECURITY_ATTRIBUTES structure contains the security descriptor for an object and specifies whether the handle retrieved by
/// specifying this structure is inheritable. This structure provides security settings for objects created by various functions, such as
/// CreateFile, CreatePipe, CreateProcess, RegCreateKeyEx, or RegSaveKeyEx.
/// </summary>
[PInvokeData("winbase.h")]
[StructLayout(LayoutKind.Sequential)]
public class SECURITY_ATTRIBUTES
{
/// <summary>The size, in bytes, of this structure. Set this value to the size of the SECURITY_ATTRIBUTES structure.</summary>
public int nLength = Marshal.SizeOf(typeof(SECURITY_ATTRIBUTES));
/// <summary>
/// A pointer to a SECURITY_DESCRIPTOR structure that controls access to the object. If the value of this member is NULL, the object
/// is assigned the default security descriptor associated with the access token of the calling process. This is not the same as
/// granting access to everyone by assigning a NULL discretionary access control list (DACL). By default, the default DACL in the
/// access token of a process allows access only to the user represented by the access token.
/// </summary>
public PSECURITY_DESCRIPTOR lpSecurityDescriptor;
/// <summary>
/// A Boolean value that specifies whether the returned handle is inherited when a new process is created. If this member is TRUE,
/// the new process inherits the handle.
/// </summary>
[MarshalAs(UnmanagedType.Bool)] public bool bInheritHandle;
}
/// <summary>
/// The SECURITY_ATTRIBUTES structure contains the security descriptor for an object and specifies whether the handle retrieved by
/// specifying this structure is inheritable. This structure provides security settings for objects created by various functions, such as
/// CreateFile, CreatePipe, CreateProcess, RegCreateKeyEx, or RegSaveKeyEx.
/// </summary>
[PInvokeData("winbase.h")]
[StructLayout(LayoutKind.Sequential)]
public struct tagSECURITY_ATTRIBUTES
{
/// <summary>The size, in bytes, of this structure. Set this value to the size of the SECURITY_ATTRIBUTES structure.</summary>
public int nLength;
/// <summary>
/// A pointer to a SECURITY_DESCRIPTOR structure that controls access to the object. If the value of this member is NULL, the object
/// is assigned the default security descriptor associated with the access token of the calling process. This is not the same as
/// granting access to everyone by assigning a NULL discretionary access control list (DACL). By default, the default DACL in the
/// access token of a process allows access only to the user represented by the access token.
/// </summary>
public PSECURITY_DESCRIPTOR lpSecurityDescriptor;
/// <summary>
/// A Boolean value that specifies whether the returned handle is inherited when a new process is created. If this member is TRUE,
/// the new process inherits the handle.
/// </summary>
[MarshalAs(UnmanagedType.Bool)] public bool bInheritHandle;
/// <summary>A default instance of this structure with the size set.</summary>
public static readonly tagSECURITY_ATTRIBUTES Default = new tagSECURITY_ATTRIBUTES { nLength = Marshal.SizeOf(typeof(SECURITY_ATTRIBUTES)) };
}
}