SECURITY_ATTRIBUTES (LWJGL 3.2.4 SNAPSHOT

java.lang.Object
- org.lwjgl.system.Pointer.Default
- - org.lwjgl.system.Struct
  - - org.lwjgl.system.windows.SECURITY_ATTRIBUTES

All Implemented Interfaces:

java.lang.AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
```
public class SECURITY_ATTRIBUTES
extends org.lwjgl.system.Struct
implements org.lwjgl.system.NativeResource
```
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.
Member documentation
- nLength – the size, in bytes, of this structure. Set this value to SIZEOF.
- lpSecurityDescriptor – 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.
- bInheritHandle – specifies whether the returned handle is inherited when a new process is created. If this member is TRUE, the new process inherits the handle.
Layout
```
 struct SECURITY_ATTRIBUTES {
     DWORD nLength;
     LPVOID lpSecurityDescriptor;
     BOOL bInheritHandle;
 }
```

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class SECURITY_ATTRIBUTES.Buffer
An array of SECURITY_ATTRIBUTES structs.
- Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer
  org.lwjgl.system.Pointer.Default

Nested Classes
Modifier and Type	Class and Description
`static class`	`SECURITY_ATTRIBUTES.Buffer` An array of `SECURITY_ATTRIBUTES` structs.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ALIGNOF` The struct alignment in bytes.
`static int`	`BINHERITHANDLE` The struct member offsets.
`static int`	`LPSECURITYDESCRIPTOR` The struct member offsets.
`static int`	`NLENGTH` The struct member offsets.
`static int`	`SIZEOF` The struct size in bytes.

Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE

Constructor Summary

Constructors
Constructor and Description
`SECURITY_ATTRIBUTES(java.nio.ByteBuffer container)` Creates a `SECURITY_ATTRIBUTES` instance at the current position of the specified `ByteBuffer` container.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`bInheritHandle()` Returns the value of the `bInheritHandle` field.
`SECURITY_ATTRIBUTES`	`bInheritHandle(boolean value)` Sets the specified value to the `bInheritHandle` field.
`static SECURITY_ATTRIBUTES`	`calloc()` Returns a new `SECURITY_ATTRIBUTES` instance allocated with `memCalloc`.
`static SECURITY_ATTRIBUTES.Buffer`	`calloc(int capacity)` Returns a new `SECURITY_ATTRIBUTES.Buffer` instance allocated with `memCalloc`.
`static SECURITY_ATTRIBUTES`	`callocStack()` Returns a new `SECURITY_ATTRIBUTES` instance allocated on the thread-local `MemoryStack` and initializes all its bits to zero.
`static SECURITY_ATTRIBUTES.Buffer`	`callocStack(int capacity)` Returns a new `SECURITY_ATTRIBUTES.Buffer` instance allocated on the thread-local `MemoryStack` and initializes all its bits to zero.
`static SECURITY_ATTRIBUTES.Buffer`	`callocStack(int capacity, org.lwjgl.system.MemoryStack stack)` Returns a new `SECURITY_ATTRIBUTES.Buffer` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static SECURITY_ATTRIBUTES`	`callocStack(org.lwjgl.system.MemoryStack stack)` Returns a new `SECURITY_ATTRIBUTES` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static SECURITY_ATTRIBUTES`	`create()` Returns a new `SECURITY_ATTRIBUTES` instance allocated with `BufferUtils`.
`static SECURITY_ATTRIBUTES.Buffer`	`create(int capacity)` Returns a new `SECURITY_ATTRIBUTES.Buffer` instance allocated with `BufferUtils`.
`static SECURITY_ATTRIBUTES`	`create(long address)` Returns a new `SECURITY_ATTRIBUTES` instance for the specified memory address.
`static SECURITY_ATTRIBUTES.Buffer`	`create(long address, int capacity)` Create a `SECURITY_ATTRIBUTES.Buffer` instance at the specified memory.
`static SECURITY_ATTRIBUTES`	`createSafe(long address)` Like `create`, but returns `null` if `address` is `NULL`.
`static SECURITY_ATTRIBUTES.Buffer`	`createSafe(long address, int capacity)` Like `create`, but returns `null` if `address` is `NULL`.
`long`	`lpSecurityDescriptor()` Returns the value of the `lpSecurityDescriptor` field.
`SECURITY_ATTRIBUTES`	`lpSecurityDescriptor(long value)` Sets the specified value to the `lpSecurityDescriptor` field.
`static SECURITY_ATTRIBUTES`	`malloc()` Returns a new `SECURITY_ATTRIBUTES` instance allocated with `memAlloc`.
`static SECURITY_ATTRIBUTES.Buffer`	`malloc(int capacity)` Returns a new `SECURITY_ATTRIBUTES.Buffer` instance allocated with `memAlloc`.
`static SECURITY_ATTRIBUTES`	`mallocStack()` Returns a new `SECURITY_ATTRIBUTES` instance allocated on the thread-local `MemoryStack`.
`static SECURITY_ATTRIBUTES.Buffer`	`mallocStack(int capacity)` Returns a new `SECURITY_ATTRIBUTES.Buffer` instance allocated on the thread-local `MemoryStack`.
`static SECURITY_ATTRIBUTES.Buffer`	`mallocStack(int capacity, org.lwjgl.system.MemoryStack stack)` Returns a new `SECURITY_ATTRIBUTES.Buffer` instance allocated on the specified `MemoryStack`.
`static SECURITY_ATTRIBUTES`	`mallocStack(org.lwjgl.system.MemoryStack stack)` Returns a new `SECURITY_ATTRIBUTES` instance allocated on the specified `MemoryStack`.
`static int`	`nbInheritHandle(long struct)` Unsafe version of `bInheritHandle()`.
`static void`	`nbInheritHandle(long struct, int value)` Unsafe version of `bInheritHandle`.
`int`	`nLength()` Returns the value of the `nLength` field.
`SECURITY_ATTRIBUTES`	`nLength(int value)` Sets the specified value to the `nLength` field.
`static long`	`nlpSecurityDescriptor(long struct)` Unsafe version of `lpSecurityDescriptor()`.
`static void`	`nlpSecurityDescriptor(long struct, long value)` Unsafe version of `lpSecurityDescriptor`.
`static int`	`nnLength(long struct)` Unsafe version of `nLength()`.
`static void`	`nnLength(long struct, int value)` Unsafe version of `nLength`.
`SECURITY_ATTRIBUTES`	`set(int nLength, long lpSecurityDescriptor, boolean bInheritHandle)` Initializes this struct with the specified values.
`SECURITY_ATTRIBUTES`	`set(SECURITY_ATTRIBUTES src)` Copies the specified struct data to this struct.
`int`	`sizeof()`
`static void`	`validate(long struct)` Validates pointer members that should not be `NULL`.
`static void`	`validate(long array, int count)` Calls `validate(long)` for each struct contained in the specified struct array.

Methods inherited from class org.lwjgl.system.Struct
clear, free, isNull

Methods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toString

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.lwjgl.system.NativeResource
close, free

- Field Detail
  - SIZEOF
```
public static final int SIZEOF
```
    The struct size in bytes.
  - ALIGNOF
```
public static final int ALIGNOF
```
    The struct alignment in bytes.
  - NLENGTH
```
public static final int NLENGTH
```
    The struct member offsets.
  - LPSECURITYDESCRIPTOR
```
public static final int LPSECURITYDESCRIPTOR
```
    The struct member offsets.
  - BINHERITHANDLE
```
public static final int BINHERITHANDLE
```
    The struct member offsets.
- Constructor Detail
  - SECURITY_ATTRIBUTES
```
public SECURITY_ATTRIBUTES(java.nio.ByteBuffer container)
```
    Creates a SECURITY_ATTRIBUTES instance at the current position of the specified ByteBuffer container. Changes to the buffer's content will be visible to the struct instance and vice versa.
    The created instance holds a strong reference to the container object.
- Method Detail
  - sizeof
```
public int sizeof()
```
    Specified by:
    
    sizeof in class org.lwjgl.system.Struct
  - nLength
```
public int nLength()
```
    Returns the value of the nLength field.
  - lpSecurityDescriptor
```
public long lpSecurityDescriptor()
```
    Returns the value of the lpSecurityDescriptor field.
  - bInheritHandle
```
public boolean bInheritHandle()
```
    Returns the value of the bInheritHandle field.
  - nLength
```
public SECURITY_ATTRIBUTES nLength(int value)
```
    Sets the specified value to the nLength field.
  - lpSecurityDescriptor
```
public SECURITY_ATTRIBUTES lpSecurityDescriptor(long value)
```
    Sets the specified value to the lpSecurityDescriptor field.
  - bInheritHandle
```
public SECURITY_ATTRIBUTES bInheritHandle(boolean value)
```
    Sets the specified value to the bInheritHandle field.
  - set
```
public SECURITY_ATTRIBUTES set(int nLength,
                               long lpSecurityDescriptor,
                               boolean bInheritHandle)
```
    Initializes this struct with the specified values.
  - set
```
public SECURITY_ATTRIBUTES set(SECURITY_ATTRIBUTES src)
```
    Copies the specified struct data to this struct.
    
    Parameters:
    
    src - the source struct
    
    Returns:
    
    this struct
  - malloc
```
public static SECURITY_ATTRIBUTES malloc()
```
    Returns a new SECURITY_ATTRIBUTES instance allocated with memAlloc. The instance must be explicitly freed.
  - calloc
```
public static SECURITY_ATTRIBUTES calloc()
```
    Returns a new SECURITY_ATTRIBUTES instance allocated with memCalloc. The instance must be explicitly freed.
  - create
```
public static SECURITY_ATTRIBUTES create()
```
    Returns a new SECURITY_ATTRIBUTES instance allocated with BufferUtils.
  - create
```
public static SECURITY_ATTRIBUTES create(long address)
```
    Returns a new SECURITY_ATTRIBUTES instance for the specified memory address.
  - createSafe
```
@Nullable
public static SECURITY_ATTRIBUTES createSafe(long address)
```
    Like create, but returns null if address is NULL.
  - malloc
```
public static SECURITY_ATTRIBUTES.Buffer malloc(int capacity)
```
    Returns a new SECURITY_ATTRIBUTES.Buffer instance allocated with memAlloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - calloc
```
public static SECURITY_ATTRIBUTES.Buffer calloc(int capacity)
```
    Returns a new SECURITY_ATTRIBUTES.Buffer instance allocated with memCalloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static SECURITY_ATTRIBUTES.Buffer create(int capacity)
```
    Returns a new SECURITY_ATTRIBUTES.Buffer instance allocated with BufferUtils.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static SECURITY_ATTRIBUTES.Buffer create(long address,
                                                int capacity)
```
    Create a SECURITY_ATTRIBUTES.Buffer instance at the specified memory.
    
    Parameters:
    
    address - the memory address
    
    capacity - the buffer capacity
  - createSafe
```
@Nullable
public static SECURITY_ATTRIBUTES.Buffer createSafe(long address,
                                                              int capacity)
```
    Like create, but returns null if address is NULL.
  - mallocStack
```
public static SECURITY_ATTRIBUTES mallocStack()
```
    Returns a new SECURITY_ATTRIBUTES instance allocated on the thread-local MemoryStack.
  - callocStack
```
public static SECURITY_ATTRIBUTES callocStack()
```
    Returns a new SECURITY_ATTRIBUTES instance allocated on the thread-local MemoryStack and initializes all its bits to zero.
  - mallocStack
```
public static SECURITY_ATTRIBUTES mallocStack(org.lwjgl.system.MemoryStack stack)
```
    Returns a new SECURITY_ATTRIBUTES instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
  - callocStack
```
public static SECURITY_ATTRIBUTES callocStack(org.lwjgl.system.MemoryStack stack)
```
    Returns a new SECURITY_ATTRIBUTES instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
  - mallocStack
```
public static SECURITY_ATTRIBUTES.Buffer mallocStack(int capacity)
```
    Returns a new SECURITY_ATTRIBUTES.Buffer instance allocated on the thread-local MemoryStack.
    
    Parameters:
    
    capacity - the buffer capacity
  - callocStack
```
public static SECURITY_ATTRIBUTES.Buffer callocStack(int capacity)
```
    Returns a new SECURITY_ATTRIBUTES.Buffer instance allocated on the thread-local MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    capacity - the buffer capacity
  - mallocStack
```
public static SECURITY_ATTRIBUTES.Buffer mallocStack(int capacity,
                                                     org.lwjgl.system.MemoryStack stack)
```
    Returns a new SECURITY_ATTRIBUTES.Buffer instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - callocStack
```
public static SECURITY_ATTRIBUTES.Buffer callocStack(int capacity,
                                                     org.lwjgl.system.MemoryStack stack)
```
    Returns a new SECURITY_ATTRIBUTES.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - nnLength
```
public static int nnLength(long struct)
```
    Unsafe version of nLength().
  - nlpSecurityDescriptor
```
public static long nlpSecurityDescriptor(long struct)
```
    Unsafe version of lpSecurityDescriptor().
  - nbInheritHandle
```
public static int nbInheritHandle(long struct)
```
    Unsafe version of bInheritHandle().
  - nnLength
```
public static void nnLength(long struct,
                            int value)
```
    Unsafe version of nLength.
  - nlpSecurityDescriptor
```
public static void nlpSecurityDescriptor(long struct,
                                         long value)
```
    Unsafe version of lpSecurityDescriptor.
  - nbInheritHandle
```
public static void nbInheritHandle(long struct,
                                   int value)
```
    Unsafe version of bInheritHandle.
  - validate
```
public static void validate(long struct)
```
    Validates pointer members that should not be NULL.
    
    Parameters:
    
    struct - the struct to validate
  - validate
```
public static void validate(long array,
                            int count)
```
    Calls validate(long) for each struct contained in the specified struct array.
    
    Parameters:
    
    array - the struct array to validate
    
    count - the number of structs in array

Class SECURITY_ATTRIBUTES

Member documentation

Layout

Nested Class Summary

Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer

Field Summary

Fields inherited from interface org.lwjgl.system.Pointer

Constructor Summary

Method Summary

Methods inherited from class org.lwjgl.system.Struct

Methods inherited from class org.lwjgl.system.Pointer.Default

Methods inherited from class java.lang.Object

Methods inherited from interface org.lwjgl.system.NativeResource

Field Detail

SIZEOF

ALIGNOF

NLENGTH

LPSECURITYDESCRIPTOR

BINHERITHANDLE

Constructor Detail

SECURITY_ATTRIBUTES

Method Detail

sizeof

nLength

lpSecurityDescriptor

bInheritHandle

nLength

lpSecurityDescriptor

bInheritHandle

set

set

malloc

calloc

create

create

createSafe

malloc

calloc

create

create

createSafe

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

nnLength

nlpSecurityDescriptor

nbInheritHandle

nnLength

nlpSecurityDescriptor

nbInheritHandle

validate

validate