JNA API 4.0.0

com.sun.jna.platform.win32
Class WinBase.SECURITY_ATTRIBUTES

java.lang.Object
  extended by com.sun.jna.Structure
      extended by com.sun.jna.platform.win32.WinBase.SECURITY_ATTRIBUTES
Enclosing interface:
WinBase

public static class WinBase.SECURITY_ATTRIBUTES
extends Structure

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 Kernel32.CreateFile(java.lang.String, int, int, com.sun.jna.platform.win32.WinBase.SECURITY_ATTRIBUTES, int, int, com.sun.jna.platform.win32.WinNT.HANDLE), Kernel32.CreatePipe(com.sun.jna.platform.win32.WinNT.HANDLEByReference, com.sun.jna.platform.win32.WinNT.HANDLEByReference, com.sun.jna.platform.win32.WinBase.SECURITY_ATTRIBUTES, int), or Advapi32.RegCreateKeyEx(com.sun.jna.platform.win32.WinReg.HKEY, java.lang.String, int, java.lang.String, int, int, com.sun.jna.platform.win32.WinBase.SECURITY_ATTRIBUTES, com.sun.jna.platform.win32.WinReg.HKEYByReference, com.sun.jna.ptr.IntByReference).


Nested Class Summary
 
Nested classes/interfaces inherited from class com.sun.jna.Structure
Structure.ByReference, Structure.ByValue, Structure.StructField
 
Field Summary
 boolean bInheritHandle
          A Boolean value that specifies whether the returned handle is inherited when a new process is created
 WinDef.DWORD dwLength
          The size of the structure, in bytes.
 Pointer lpSecurityDescriptor
          A pointer to a SECURITY_DESCRIPTOR structure that controls access to the object.
 
Fields inherited from class com.sun.jna.Structure
ALIGN_DEFAULT, ALIGN_GNUC, ALIGN_MSVC, ALIGN_NONE, CALCULATE_SIZE
 
Constructor Summary
WinBase.SECURITY_ATTRIBUTES()
           
 
Method Summary
protected  List getFieldOrder()
          Return this Structure's field names in their proper order.
 
Methods inherited from class com.sun.jna.Structure
allocateMemory, allocateMemory, autoAllocate, autoRead, autoRead, autoWrite, autoWrite, cacheTypeInfo, clear, ensureAllocated, equals, fieldOffset, getAutoRead, getAutoWrite, getFieldList, getFields, getNativeAlignment, getNativeSize, getNativeSize, getPointer, getStringEncoding, getStructAlignment, hashCode, newInstance, newInstance, read, readField, readField, setAlignType, setAutoRead, setAutoSynch, setAutoWrite, setFieldOrder, setStringEncoding, size, sortFields, toArray, toArray, toString, toString, useMemory, useMemory, write, writeField, writeField, writeField
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

dwLength

public WinDef.DWORD dwLength
The size of the structure, in bytes.


lpSecurityDescriptor

public Pointer lpSecurityDescriptor
A pointer to a SECURITY_DESCRIPTOR structure that controls access to the object.


bInheritHandle

public boolean bInheritHandle
A Boolean value that specifies whether the returned handle is inherited when a new process is created

Constructor Detail

WinBase.SECURITY_ATTRIBUTES

public WinBase.SECURITY_ATTRIBUTES()
Method Detail

getFieldOrder

protected List getFieldOrder()
Description copied from class: Structure
Return this Structure's field names in their proper order. For example,

 protected List getFieldOrder() {
     return Arrays.asList(new String[] { ... });
 }
 
IMPORTANT When deriving from an existing Structure subclass, ensure that you augment the list provided by the superclass, e.g.

 protected List getFieldOrder() {
     List fields = new ArrayList(super.getFieldOrder());
     fields.addAll(Arrays.asList(new String[] { ... }));
     return fields;
 }
 
Field order must be explicitly indicated, since the field order as returned by Class.getFields() is not guaranteed to be predictable.

Specified by:
getFieldOrder in class Structure

JNA API 4.0.0

Copyright © 2007-2013 Timothy Wall. All Rights Reserved.