Package org.lwjgl.system.windows
Class SECURITY_ATTRIBUTES
- 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 asCreateFile
,CreatePipe
,CreateProcess
,RegCreateKeyEx
, orRegSaveKeyEx
.Layout
struct SECURITY_ATTRIBUTES { DWORD
nLength()
; LPVOIDlpSecurityDescriptor()
; BOOLbInheritHandle()
; }
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
SECURITY_ATTRIBUTES.Buffer
An array ofSECURITY_ATTRIBUTES
structs.
-
Field Summary
Fields Modifier and Type Field Description static int
ALIGNOF
The struct alignment in bytes.static int
BINHERITHANDLE
LPSECURITYDESCRIPTOR
NLENGTHThe struct member offsets.static int
SIZEOF
The struct size in bytes.
-
Constructor Summary
Constructors Constructor Description SECURITY_ATTRIBUTES(java.nio.ByteBuffer container)
Creates aSECURITY_ATTRIBUTES
instance at the current position of the specifiedByteBuffer
container.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description boolean
bInheritHandle()
specifies whether the returned handle is inherited when a new process is created.SECURITY_ATTRIBUTES
bInheritHandle(boolean value)
Sets the specified value to thebInheritHandle()
field.static SECURITY_ATTRIBUTES
calloc()
Returns a newSECURITY_ATTRIBUTES
instance allocated withmemCalloc
.static SECURITY_ATTRIBUTES.Buffer
calloc(int capacity)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated withmemCalloc
.static SECURITY_ATTRIBUTES.Buffer
calloc(int capacity, org.lwjgl.system.MemoryStack stack)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated on the specifiedMemoryStack
and initializes all its bits to zero.static SECURITY_ATTRIBUTES
calloc(org.lwjgl.system.MemoryStack stack)
Returns a newSECURITY_ATTRIBUTES
instance allocated on the specifiedMemoryStack
and initializes all its bits to zero.static SECURITY_ATTRIBUTES
callocStack()
Deprecated.static SECURITY_ATTRIBUTES.Buffer
callocStack(int capacity)
Deprecated.static SECURITY_ATTRIBUTES.Buffer
callocStack(int capacity, org.lwjgl.system.MemoryStack stack)
Deprecated.static SECURITY_ATTRIBUTES
callocStack(org.lwjgl.system.MemoryStack stack)
Deprecated.static SECURITY_ATTRIBUTES
create()
Returns a newSECURITY_ATTRIBUTES
instance allocated withBufferUtils
.static SECURITY_ATTRIBUTES.Buffer
create(int capacity)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated withBufferUtils
.static SECURITY_ATTRIBUTES
create(long address)
Returns a newSECURITY_ATTRIBUTES
instance for the specified memory address.static SECURITY_ATTRIBUTES.Buffer
create(long address, int capacity)
Create aSECURITY_ATTRIBUTES.Buffer
instance at the specified memory.static SECURITY_ATTRIBUTES
createSafe(long address)
static SECURITY_ATTRIBUTES.Buffer
createSafe(long address, int capacity)
long
lpSecurityDescriptor()
a pointer to aSECURITY_DESCRIPTOR
structure that controls access to the object.SECURITY_ATTRIBUTES
lpSecurityDescriptor(long value)
Sets the specified value to thelpSecurityDescriptor()
field.static SECURITY_ATTRIBUTES
malloc()
Returns a newSECURITY_ATTRIBUTES
instance allocated withmemAlloc
.static SECURITY_ATTRIBUTES.Buffer
malloc(int capacity)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated withmemAlloc
.static SECURITY_ATTRIBUTES.Buffer
malloc(int capacity, org.lwjgl.system.MemoryStack stack)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated on the specifiedMemoryStack
.static SECURITY_ATTRIBUTES
malloc(org.lwjgl.system.MemoryStack stack)
Returns a newSECURITY_ATTRIBUTES
instance allocated on the specifiedMemoryStack
.static SECURITY_ATTRIBUTES
mallocStack()
Deprecated.static SECURITY_ATTRIBUTES.Buffer
mallocStack(int capacity)
Deprecated.static SECURITY_ATTRIBUTES.Buffer
mallocStack(int capacity, org.lwjgl.system.MemoryStack stack)
Deprecated.static SECURITY_ATTRIBUTES
mallocStack(org.lwjgl.system.MemoryStack stack)
Deprecated.static int
nbInheritHandle(long struct)
Unsafe version ofbInheritHandle()
.static void
nbInheritHandle(long struct, int value)
Unsafe version ofbInheritHandle
.int
nLength()
the size, in bytes, of this structure.SECURITY_ATTRIBUTES
nLength(int value)
Sets the specified value to thenLength()
field.static long
nlpSecurityDescriptor(long struct)
Unsafe version oflpSecurityDescriptor()
.static void
nlpSecurityDescriptor(long struct, long value)
Unsafe version oflpSecurityDescriptor
.static int
nnLength(long struct)
Unsafe version ofnLength()
.static void
nnLength(long struct, int value)
Unsafe version ofnLength
.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 beNULL
.
-
-
-
Constructor Detail
-
SECURITY_ATTRIBUTES
public SECURITY_ATTRIBUTES(java.nio.ByteBuffer container)
Creates aSECURITY_ATTRIBUTES
instance at the current position of the specifiedByteBuffer
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 classorg.lwjgl.system.Struct
-
nLength
public int nLength()
the size, in bytes, of this structure. Set this value toSIZEOF
.
-
lpSecurityDescriptor
public long lpSecurityDescriptor()
a pointer to aSECURITY_DESCRIPTOR
structure that controls access to the object. If the value of this member isNULL
, 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 aNULL
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
public boolean bInheritHandle()
specifies whether the returned handle is inherited when a new process is created. If this member isTRUE
, the new process inherits the handle.
-
nLength
public SECURITY_ATTRIBUTES nLength(int value)
Sets the specified value to thenLength()
field.
-
lpSecurityDescriptor
public SECURITY_ATTRIBUTES lpSecurityDescriptor(long value)
Sets the specified value to thelpSecurityDescriptor()
field.
-
bInheritHandle
public SECURITY_ATTRIBUTES bInheritHandle(boolean value)
Sets the specified value to thebInheritHandle()
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 newSECURITY_ATTRIBUTES
instance allocated withmemAlloc
. The instance must be explicitly freed.
-
calloc
public static SECURITY_ATTRIBUTES calloc()
Returns a newSECURITY_ATTRIBUTES
instance allocated withmemCalloc
. The instance must be explicitly freed.
-
create
public static SECURITY_ATTRIBUTES create()
Returns a newSECURITY_ATTRIBUTES
instance allocated withBufferUtils
.
-
create
public static SECURITY_ATTRIBUTES create(long address)
Returns a newSECURITY_ATTRIBUTES
instance for the specified memory address.
-
createSafe
@Nullable public static SECURITY_ATTRIBUTES createSafe(long address)
-
malloc
public static SECURITY_ATTRIBUTES.Buffer malloc(int capacity)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated withmemAlloc
. The instance must be explicitly freed.- Parameters:
capacity
- the buffer capacity
-
calloc
public static SECURITY_ATTRIBUTES.Buffer calloc(int capacity)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated withmemCalloc
. The instance must be explicitly freed.- Parameters:
capacity
- the buffer capacity
-
create
public static SECURITY_ATTRIBUTES.Buffer create(int capacity)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated withBufferUtils
.- Parameters:
capacity
- the buffer capacity
-
create
public static SECURITY_ATTRIBUTES.Buffer create(long address, int capacity)
Create aSECURITY_ATTRIBUTES.Buffer
instance at the specified memory.- Parameters:
address
- the memory addresscapacity
- the buffer capacity
-
createSafe
@Nullable public static SECURITY_ATTRIBUTES.Buffer createSafe(long address, int capacity)
-
mallocStack
@Deprecated public static SECURITY_ATTRIBUTES mallocStack()
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(MemoryStack)
instead.
-
callocStack
@Deprecated public static SECURITY_ATTRIBUTES callocStack()
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(MemoryStack)
instead.
-
mallocStack
@Deprecated public static SECURITY_ATTRIBUTES mallocStack(org.lwjgl.system.MemoryStack stack)
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(MemoryStack)
instead.
-
callocStack
@Deprecated public static SECURITY_ATTRIBUTES callocStack(org.lwjgl.system.MemoryStack stack)
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(MemoryStack)
instead.
-
mallocStack
@Deprecated public static SECURITY_ATTRIBUTES.Buffer mallocStack(int capacity)
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(int, MemoryStack)
instead.
-
callocStack
@Deprecated public static SECURITY_ATTRIBUTES.Buffer callocStack(int capacity)
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(int, MemoryStack)
instead.
-
mallocStack
@Deprecated public static SECURITY_ATTRIBUTES.Buffer mallocStack(int capacity, org.lwjgl.system.MemoryStack stack)
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(int, MemoryStack)
instead.
-
callocStack
@Deprecated public static SECURITY_ATTRIBUTES.Buffer callocStack(int capacity, org.lwjgl.system.MemoryStack stack)
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(int, MemoryStack)
instead.
-
malloc
public static SECURITY_ATTRIBUTES malloc(org.lwjgl.system.MemoryStack stack)
Returns a newSECURITY_ATTRIBUTES
instance allocated on the specifiedMemoryStack
.- Parameters:
stack
- the stack from which to allocate
-
calloc
public static SECURITY_ATTRIBUTES calloc(org.lwjgl.system.MemoryStack stack)
Returns a newSECURITY_ATTRIBUTES
instance allocated on the specifiedMemoryStack
and initializes all its bits to zero.- Parameters:
stack
- the stack from which to allocate
-
malloc
public static SECURITY_ATTRIBUTES.Buffer malloc(int capacity, org.lwjgl.system.MemoryStack stack)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated on the specifiedMemoryStack
.- Parameters:
stack
- the stack from which to allocatecapacity
- the buffer capacity
-
calloc
public static SECURITY_ATTRIBUTES.Buffer calloc(int capacity, org.lwjgl.system.MemoryStack stack)
Returns a newSECURITY_ATTRIBUTES.Buffer
instance allocated on the specifiedMemoryStack
and initializes all its bits to zero.- Parameters:
stack
- the stack from which to allocatecapacity
- the buffer capacity
-
nnLength
public static int nnLength(long struct)
Unsafe version ofnLength()
.
-
nlpSecurityDescriptor
public static long nlpSecurityDescriptor(long struct)
Unsafe version oflpSecurityDescriptor()
.
-
nbInheritHandle
public static int nbInheritHandle(long struct)
Unsafe version ofbInheritHandle()
.
-
nnLength
public static void nnLength(long struct, int value)
Unsafe version ofnLength
.
-
nlpSecurityDescriptor
public static void nlpSecurityDescriptor(long struct, long value)
Unsafe version oflpSecurityDescriptor
.
-
nbInheritHandle
public static void nbInheritHandle(long struct, int value)
Unsafe version ofbInheritHandle
.
-
validate
public static void validate(long struct)
Validates pointer members that should not beNULL
.- Parameters:
struct
- the struct to validate
-
-