Package com.sun.jna.platform.win32

# Class Kernel32Util

java.lang.Object
com.sun.jna.platform.win32.Kernel32Util

All Implemented Interfaces:
  `WinDef`

public abstract class Kernel32Util extends Object implements WinDef
Kernel32 utility API.

Author:
  dblock[at]dblock.org, markus[at]headcrashing[dot]eu, Andreas "PAX" Lück, onkelpax-git[at]yahoo.de

- ## Nested Class Summary

  ## Nested classes/interfaces inherited from interface com.sun.jna.platform.win32.WinDef

  `WinDef.ATOM, WinDef.BOOL, WinDef.BOOLByReference, WinDef.BYTE, WinDef.CHAR, WinDef.CHARByReference, WinDef.DWORD, WinDef.DWORDByReference, WinDef.DWORDLONG, WinDef.HBITMAP, WinDef.HBRUSH, WinDef.HCURSOR, WinDef.HDC, WinDef.HFONT, WinDef.HGLRC, WinDef.HGLRCByReference, WinDef.HICON, WinDef.HINSTANCE, WinDef.HKL, WinDef.HMENU, WinDef.HMODULE, WinDef.HPALETTE, WinDef.HPEN, WinDef.HRGN, WinDef.HRSRC, WinDef.HWND, WinDef.INT_PTR, WinDef.LCID, WinDef.LONG, WinDef.LONGByReference, WinDef.LONGLONG, WinDef.LONGLONGByReference, WinDef.LPARAM, WinDef.LPVOID, WinDef.LRESULT, WinDef.POINT, WinDef.PVOID, WinDef.RECT, WinDef.SCODE, WinDef.SCODEByReference, WinDef.SHORT, WinDef.UCHAR, WinDef.UINT, WinDef.UINT_PTR, WinDef.UINTByReference, WinDef.ULONG, WinDef.ULONGByReference, WinDef.ULONGLONG, WinDef.ULONGLONGByReference, WinDef.USHORT, WinDef.USHORTByReference, WinDef.WORD, WinDef.WORDByReference, WinDef.WPARAM`

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `static final String`
  `VOLUME_GUID_PATH_PREFIX`
  `static final String`
  `VOLUME_GUID_PATH_SUFFIX`

  ### Fields inherited from interface com.sun.jna.platform.win32.WinDef

  `MAX_PATH`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `Kernel32Util()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `static void`
  `closeHandle(WinNT.HANDLE h)`
  Invokes `Kernel32.CloseHandle(WinNT.HANDLE)` and checks the success code.
  `static void`
  `closeHandleRef(WinNT.HANDLEByReference ref)`
  Closes the handle in the reference
  `static void`
  `closeHandleRefs(WinNT.HANDLEByReference... refs)`
  Closes all referenced handles.
  `static void`
  `closeHandles(WinNT.HANDLE... handles)`
  Invokes `closeHandle(WinNT.HANDLE)` on each handle.
  `static void`
  `deleteFile(String filename)`
  `static String`
  `expandEnvironmentStrings(String input)`
  Expands environment-variable strings and replaces them with the values defined for the current user.
  `static final String`
  `extractVolumeGUID(String volumeGUIDPath)`
  Parses and returns the pure GUID value of a volume name obtained from `Kernel32.FindFirstVolume(char[], int)` or `Kernel32.FindNextVolume(com.sun.jna.platform.win32.WinNT.HANDLE, char[], int)` calls
  `static long`
  `findEnvironmentStringBlockEntryEnd(Pointer lpszEnvironmentBlock, long offset, boolean asWideChars)`
  `static String`
  `formatMessage(int code)`
  Format a message from a code.
  `static String`
  `formatMessage(int code, int primaryLangId, int sublangId)`
  Format a message from the value obtained from `Kernel32.GetLastError()` or `Native.getLastError()`.
  `static String`
  `formatMessage(WinNT.HRESULT code)`
  Format a message from an HRESULT.
  `static String`
  `formatMessage(WinNT.HRESULT code, int primaryLangId, int sublangId)`
  Format a message from an HRESULT.
  `static String`
  `formatMessageFromLastErrorCode(int code)`
  Format a system message from an error code.
  `static String`
  `formatMessageFromLastErrorCode(int code, int primaryLangId, int sublangId)`
  Format a system message from an error code.
  `static void`
  `freeGlobalMemory(Pointer ptr)`
  Invokes `Kernel32.GlobalFree(Pointer)` and checks if it succeeded.
  `static void`
  `freeLocalMemory(Pointer ptr)`
  Invokes `Kernel32.LocalFree(Pointer)` and checks if it succeeded.
  `static String`
  `getComputerName()`
  Get current computer NetBIOS name.
  `static WinDef.DWORD`
  `getCurrentProcessPriority()`
  Gets the priority class of the current process.
  `static int`
  `getCurrentThreadPriority()`
  Gets the priority value of the current thread.
  `static int`
  `getDriveType(String rootName)`
  `static String`
  `getEnvironmentVariable(String name)`
  Get the value of an environment variable.
  `static Map<String,String>`
  `getEnvironmentVariables()`
  Uses the `Kernel32.GetEnvironmentStrings()` to retrieve and parse the current process environment
  `static Map<String,String>`
  `getEnvironmentVariables(Pointer lpszEnvironmentBlock, long offset)`
  `static int`
  `getFileAttributes(String fileName)`
  Retrieves file system attributes for a specified file or directory.
  `static int`
  `getFileType(String fileName)`
  Retrieves the result of GetFileType, provided the file exists.
  `static String`
  `getLastErrorMessage()`
  `static String`
  `getLastErrorMessage(int primaryLangId, int sublangId)`
  `static List<String>`
  `getLogicalDriveStrings()`
  Returns valid drives in the system.
  `static final WinNT.SYSTEM_LOGICAL_PROCESSOR_INFORMATION[]`
  `getLogicalProcessorInformation()`
  Convenience method to get the processor information.
  `static final WinNT.SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX[]`
  `getLogicalProcessorInformationEx(int relationshipType)`
  Convenience method to get the processor information.
  `static List<Tlhelp32.MODULEENTRY32W>`
  `getModules(int processID)`
  Returns all the executable modules for a given process ID.
  `static final int`
  `getPrivateProfileInt(String appName, String keyName, int defaultValue, String fileName)`
  Retrieves an integer associated with a key in the specified section of an initialization file.
  `static final String[]`
  `getPrivateProfileSection(String appName, String fileName)`
  Retrieves all the keys and values for the specified section of an initialization file.
  `static final String[]`
  `getPrivateProfileSectionNames(String fileName)`
  Retrieves the names of all sections in an initialization file.
  `static final String`
  `getPrivateProfileString(String lpAppName, String lpKeyName, String lpDefault, String lpFileName)`
  Retrieves a string from the specified section in an initialization file.
  `static WinDef.DWORD`
  `getProcessPriority(int pid)`
  Gets the priority class of the specified process.
  `static byte[]`
  `getResource(String path, String type, String name)`
  Gets the specified resource out of the specified executable file
  `static Map<String,List<String>>`
  `getResourceNames(String path)`
  Gets a list of all resources from the specified executable file
  `static String`
  `getTempPath()`
  Return the path designated for temporary files.
  `static int`
  `getThreadPriority(int tid)`
  Gets the priority value of the specified thread.
  `static final List<String>`
  `getVolumePathNamesForVolumeName(String lpszVolumeName)`
  Invokes and parses the result of `Kernel32.GetVolumePathNamesForVolumeName(String, char[], int, IntByReference)`
  `static boolean`
  `isValidPriorityClass(WinDef.DWORD dwPriorityClass)`
  Test whether the given priority class is valid.
  `static boolean`
  `isValidThreadPriority(int nPriority)`
  Test whether the given thread priority is valid.
  `static boolean`
  `isWideCharEnvironmentStringBlock(Pointer lpszEnvironmentBlock, long offset)`
  Attempts to determine whether the data block uses `wchar_t` instead of "plain old" `char`s.
  `static final List<String>`
  `queryDosDevice(String lpszDeviceName, int maxTargetSize)`
  Invokes the `Kernel32.QueryDosDevice(String, char[], int)` method and parses the result
  `static final String`
  `QueryFullProcessImageName(int pid, int dwFlags)`
  This function retrieves the full path of the executable file of a given process identifier.
  `static final String`
  `QueryFullProcessImageName(WinNT.HANDLE hProcess, int dwFlags)`
  This function retrieves the full path of the executable file of a given process.
  `static String`
  `readEnvironmentStringBlockEntry(Pointer lpszEnvironmentBlock, long offset, boolean asWideChars)`
  `static void`
  `setCurrentProcessBackgroundMode(boolean enable)`
  Enables or disables "background" processing mode for the current process
  `static void`
  `setCurrentProcessPriority(WinDef.DWORD dwPriorityClass)`
  Sets the priority class for the current process.
  `static void`
  `setCurrentThreadBackgroundMode(boolean enable)`
  Enables or disables "background" processing mode for the current thread
  `static void`
  `setCurrentThreadPriority(int nPriority)`
  Sets the priority value for the current thread.
  `static void`
  `setProcessPriority(int pid, WinDef.DWORD dwPriorityClass)`
  Sets the priority class for the specified process.
  `static void`
  `setThreadPriority(int tid, int nPriority)`
  Sets the priority value for the specified thread.
  `static final void`
  `writePrivateProfileSection(String appName, String[] strings, String fileName)`
  `static final void`
  `writePrivateProfileString(String appName, String keyName, String string, String fileName)`

  ### Methods inherited from class java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Field Details

  - ### VOLUME_GUID_PATH_PREFIX

    public static final String VOLUME_GUID_PATH_PREFIX
    See Also:
      - Constant Field Values

  - ### VOLUME_GUID_PATH_SUFFIX

    public static final String VOLUME_GUID_PATH_SUFFIX
    See Also:
      - Constant Field Values

- ## Constructor Details

  - ### Kernel32Util

    public Kernel32Util()

- ## Method Details

  - ### getComputerName

    public static String getComputerName()
    Get current computer NetBIOS name.
    Returns:
      Netbios name.

  - ### freeLocalMemory

    public static void freeLocalMemory(Pointer ptr)
    Invokes `Kernel32.LocalFree(Pointer)` and checks if it succeeded.
    Parameters:
      `ptr` - The `Pointer` to the memory to be released - ignored if NULL
    Throws:
      `Win32Exception` - if non-`ERROR_SUCCESS` code reported

  - ### freeGlobalMemory

    public static void freeGlobalMemory(Pointer ptr)
    Invokes `Kernel32.GlobalFree(Pointer)` and checks if it succeeded.
    Parameters:
      `ptr` - The `Pointer` to the memory to be released - ignored if NULL
    Throws:
      `Win32Exception` - if non-`ERROR_SUCCESS` code reported

  - ### closeHandleRefs

    public static void closeHandleRefs(WinNT.HANDLEByReference... refs)
    Closes all referenced handles. If an exception is thrown for a specific handle, then it is accumulated until all handles have been closed. If more than one exception occurs, then it is added as a suppressed exception to the first one. Once closed all handles, the accumulated exception (if any) is thrown
    Parameters:
      `refs` - The references to close
    See Also:
      - `closeHandleRef(WinNT.HANDLEByReference)`

  - ### closeHandleRef

    public static void closeHandleRef(WinNT.HANDLEByReference ref)
    Closes the handle in the reference
    Parameters:
      `ref` - The handle reference - ignored if `null`
    See Also:
      - `closeHandle(WinNT.HANDLE)`

  - ### closeHandles

    public static void closeHandles(WinNT.HANDLE... handles)
    Invokes `closeHandle(WinNT.HANDLE)` on each handle. If an exception is thrown for a specific handle, then it is accumulated until all handles have been closed. If more than one exception occurs, then it is added as a suppressed exception to the first one. Once closed all handles, the accumulated exception (if any) is thrown
    Parameters:
      `handles` - The handles to be closed
    See Also:
      - `Throwable.getSuppressed()`

  - ### closeHandle

    public static void closeHandle(WinNT.HANDLE h)
    Invokes `Kernel32.CloseHandle(WinNT.HANDLE)` and checks the success code. If not successful, then throws a `Win32Exception` with the `GetLastError` value
    Parameters:
      `h` - The handle to be closed - ignored if `null`

  - ### formatMessage

    public static String formatMessage(int code)
    Format a message from a code.
    Parameters:
      `code` - The error code
    Returns:
      Formatted message in the default locale.

  - ### formatMessage

    public static String formatMessage(int code, int primaryLangId, int sublangId)
    Format a message from the value obtained from `Kernel32.GetLastError()` or `Native.getLastError()`.

    If you pass in zero, FormatMessage looks for a message for LANGIDs in the following order:

    1. Language neutral
    2. Thread LANGID, based on the thread's locale value
    3. User default LANGID, based on the user's default locale value
    4. System default LANGID, based on the system default locale value
    5. US English
    Parameters:
      `code` - The error code
      `primaryLangId` - The primary language identifier
      `sublangId` - The sublanguage identifier
    Returns:
      Formatted message in the specified locale.

  - ### formatMessage

    public static String formatMessage(WinNT.HRESULT code)
    Format a message from an HRESULT.
    Parameters:
      `code` - HRESULT
    Returns:
      Formatted message in the default locale.

  - ### formatMessage

    public static String formatMessage(WinNT.HRESULT code, int primaryLangId, int sublangId)
    Format a message from an HRESULT.
    Parameters:
      `code` - HRESULT
      `primaryLangId` - The primary language identifier
      `sublangId` - The primary language identifier
    Returns:
      Formatted message in the specified locale.

  - ### formatMessageFromLastErrorCode

    public static String formatMessageFromLastErrorCode(int code)
    Format a system message from an error code.
    Parameters:
      `code` - Error code, typically a result of GetLastError.
    Returns:
      Formatted message in the default locale.

  - ### formatMessageFromLastErrorCode

    public static String formatMessageFromLastErrorCode(int code, int primaryLangId, int sublangId)
    Format a system message from an error code.
    Parameters:
      `code` - Error code, typically a result of GetLastError.
      `primaryLangId` - The primary language identifier
      `sublangId` - The primary language identifier
    Returns:
      Formatted message in the specified locale.

  - ### getLastErrorMessage

    public static String getLastErrorMessage()
    Returns:
      Obtains the human-readable error message text from the last error that occurred by invocating `Kernel32.GetLastError()` in the default locale.

  - ### getLastErrorMessage

    public static String getLastErrorMessage(int primaryLangId, int sublangId)
    Returns:
      Obtains the human-readable error message text from the last error that occurred by invocating `Kernel32.GetLastError()` in the specified locale.

  - ### getTempPath

    public static String getTempPath()
    Return the path designated for temporary files.
    Returns:
      Path.

  - ### deleteFile

    public static void deleteFile(String filename)

  - ### getLogicalDriveStrings

    public static List<String> getLogicalDriveStrings()
    Returns valid drives in the system.
    Returns:
      A `List` of valid drives.

  - ### getFileAttributes

    public static int getFileAttributes(String fileName)
    Retrieves file system attributes for a specified file or directory.
    Parameters:
      `fileName` - The name of the file or directory.
    Returns:
      The attributes of the specified file or directory.

  - ### getFileType

    public static int getFileType(String fileName) throws FileNotFoundException
    Retrieves the result of GetFileType, provided the file exists.
    Parameters:
      `fileName` - file name
    Returns:
      file type
    Throws:
      `FileNotFoundException` - if file not found

  - ### getDriveType

    public static int getDriveType(String rootName)
    Parameters:
      `rootName` - name of root drive
    Returns:
      One of the WinBase.DRIVE_* constants.

  - ### getEnvironmentVariable

    public static String getEnvironmentVariable(String name)
    Get the value of an environment variable.
    Parameters:
      `name` - Name of the environment variable.
    Returns:
      Value of an environment variable.

  - ### getEnvironmentVariables

    public static Map<String,String> getEnvironmentVariables()
    Uses the `Kernel32.GetEnvironmentStrings()` to retrieve and parse the current process environment
    Returns:
      The current process environment as a `Map`.
    Throws:
      `LastErrorException` - if failed to get or free the environment data block
    See Also:
      - `getEnvironmentVariables(Pointer, long)`

  - ### getEnvironmentVariables

    public static Map<String,String> getEnvironmentVariables(Pointer lpszEnvironmentBlock, long offset)
    Parameters:
      `lpszEnvironmentBlock` - The environment block as received from the GetEnvironmentStrings function
      `offset` - Offset within the block to parse the data
    Returns:
      A `Map` of the parsed `name=value` pairs. Note: if the environment block is `null` then `null` is returned instead of an empty map since we want to distinguish between the case that the data block is `null` and when there are no environment variables (as unlikely as it may be)

  - ### readEnvironmentStringBlockEntry

    public static String readEnvironmentStringBlockEntry(Pointer lpszEnvironmentBlock, long offset, boolean asWideChars)
    Parameters:
      `lpszEnvironmentBlock` - The environment block as received from the GetEnvironmentStrings function
      `offset` - Offset within the block to look for the entry
      `asWideChars` - If `true` then the block contains `wchar_t` instead of "plain old" `char`s
    Returns:
      A `String` containing the `name=value` pair or empty if reached end of block
    See Also:
      - `isWideCharEnvironmentStringBlock(com.sun.jna.Pointer, long)`
      - `findEnvironmentStringBlockEntryEnd(com.sun.jna.Pointer, long, boolean)`

  - ### findEnvironmentStringBlockEntryEnd

    public static long findEnvironmentStringBlockEntryEnd(Pointer lpszEnvironmentBlock, long offset, boolean asWideChars)
    Parameters:
      `lpszEnvironmentBlock` - The environment block as received from the GetEnvironmentStrings function
      `offset` - Offset within the block to look for the entry
      `asWideChars` - If `true` then the block contains `wchar_t` instead of "plain old" `char`s
    Returns:
      The offset of the first `'\0'` in the data block starting at the specified offset - can be the start offset itself if empty string.
    See Also:
      - `isWideCharEnvironmentStringBlock(com.sun.jna.Pointer, long)`

  - ### isWideCharEnvironmentStringBlock

    public static boolean isWideCharEnvironmentStringBlock(Pointer lpszEnvironmentBlock, long offset)

    Attempts to determine whether the data block uses `wchar_t` instead of "plain old" `char`s. It does that by reading 2 bytes from the specified offset - the character value and its charset indicator - and examining them as follows:

    - If the charset indicator is non-zero then it is assumed to be a "plain old" `char`s data block. Note: the assumption is that the environment variable name (at least) is ASCII.
    - Otherwise (i.e., zero charset indicator), it is assumed to be a `wchar_t`
    Note: the code takes into account the `ByteOrder` even though only `ByteOrder.LITTLE_ENDIAN` is the likely one
    Parameters:
      `lpszEnvironmentBlock` - The environment block as received from the GetEnvironmentStrings function
      `offset` - offset
    Returns:
      `true` if the block contains `wchar_t` instead of "plain old" `char`s

  - ### getPrivateProfileInt

    public static final int getPrivateProfileInt(String appName, String keyName, int defaultValue, String fileName)
    Retrieves an integer associated with a key in the specified section of an initialization file.
    Parameters:
      `appName` - The name of the section in the initialization file.
      `keyName` - The name of the key whose value is to be retrieved. This value is in the form of a string; the `Kernel32.GetPrivateProfileInt(java.lang.String, java.lang.String, int, java.lang.String)` function converts the string into an integer and returns the integer.
      `defaultValue` - The default value to return if the key name cannot be found in the initialization file.
      `fileName` - The name of the initialization file. If this parameter does not contain a full path to the file, the system searches for the file in the Windows directory.
    Returns:
      The retrieved integer, or the default if not found.

  - ### getPrivateProfileString

    public static final String getPrivateProfileString(String lpAppName, String lpKeyName, String lpDefault, String lpFileName)
    Retrieves a string from the specified section in an initialization file.
    Parameters:
      `lpAppName` - The name of the section containing the key name. If this parameter is `null`, the `Kernel32.GetPrivateProfileString(java.lang.String, java.lang.String, java.lang.String, char[], com.sun.jna.platform.win32.WinDef.DWORD, java.lang.String)` function copies all section names in the file to the supplied buffer.
      `lpKeyName` - The name of the key whose associated string is to be retrieved. If this parameter is `null`, all key names in the section specified by the `lpAppName` parameter are returned.
      `lpDefault` - A default string. If the `lpKeyName` key cannot be found in the initialization file, `Kernel32.GetPrivateProfileString(java.lang.String, java.lang.String, java.lang.String, char[], com.sun.jna.platform.win32.WinDef.DWORD, java.lang.String)` returns the default. If this parameter is `null`, the default is an empty string, `""`.

      Avoid specifying a default string with trailing blank characters. The function inserts a `null` character in the `lpReturnedString` buffer to strip any trailing blanks.

      `lpFileName` - The name of the initialization file. If this parameter does not contain a full path to the file, the system searches for the file in the Windows directory.
    Returns:

      If neither `lpAppName` nor `lpKeyName` is `null` and the destination buffer is too small to hold the requested string, the string is truncated.

      If either `lpAppName` or `lpKeyName` is `null` and the destination buffer is too small to hold all the strings, the last string is truncated and followed by two `null` characters.

      In the event the initialization file specified by `lpFileName` is not found, or contains invalid values, this function will set errorno with a value of '0x2' (File Not Found). To retrieve extended error information, call `Kernel32.GetLastError()`.

  - ### writePrivateProfileString

    public static final void writePrivateProfileString(String appName, String keyName, String string, String fileName)

  - ### getLogicalProcessorInformation

    public static final WinNT.SYSTEM_LOGICAL_PROCESSOR_INFORMATION[] getLogicalProcessorInformation()
    Convenience method to get the processor information. Takes care of auto-growing the array.
    Returns:
      the array of processor information.

  - ### getLogicalProcessorInformationEx

    public static final WinNT.SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX[] getLogicalProcessorInformationEx(int relationshipType)
    Convenience method to get the processor information. Takes care of auto-growing the array and populating variable-length arrays in structures.
    Parameters:
      `relationshipType` - The type of relationship to retrieve. This parameter can be one of the following values: `WinNT.LOGICAL_PROCESSOR_RELATIONSHIP.RelationCache`, `WinNT.LOGICAL_PROCESSOR_RELATIONSHIP.RelationGroup`, `WinNT.LOGICAL_PROCESSOR_RELATIONSHIP.RelationNumaNode`, `WinNT.LOGICAL_PROCESSOR_RELATIONSHIP.RelationProcessorCore`, `WinNT.LOGICAL_PROCESSOR_RELATIONSHIP.RelationProcessorPackage`, or `WinNT.LOGICAL_PROCESSOR_RELATIONSHIP.RelationAll`
    Returns:
      the array of processor information.

  - ### getPrivateProfileSection

    public static final String[] getPrivateProfileSection(String appName, String fileName)
    Retrieves all the keys and values for the specified section of an initialization file.

    Each string has the following format: `key=string`.

    This operation is atomic; no updates to the specified initialization file are allowed while this method is executed.

    Parameters:
      `appName` - The name of the section in the initialization file.
      `fileName` - The name of the initialization file. If this parameter does not contain a full path to the file, the system searches for the file in the Windows directory.
    Returns:
      The key name and value pairs associated with the named section.

  - ### getPrivateProfileSectionNames

    public static final String[] getPrivateProfileSectionNames(String fileName)
    Retrieves the names of all sections in an initialization file.

    This operation is atomic; no updates to the initialization file are allowed while this method is executed.

    Parameters:
      `fileName` - The name of the initialization file. If this parameter is `NULL`, the function searches the Win.ini file. If this parameter does not contain a full path to the file, the system searches for the file in the Windows directory.
    Returns:
      the section names associated with the named file.

  - ### writePrivateProfileSection

    public static final void writePrivateProfileSection(String appName, String[] strings, String fileName)
    Parameters:
      `appName` - The name of the section in which data is written. This section name is typically the name of the calling application.
      `strings` - The new key names and associated values that are to be written to the named section. Each entry must be of the form `key=value`.
      `fileName` - The name of the initialization file. If this parameter does not contain a full path for the file, the function searches the Windows directory for the file. If the file does not exist and lpFileName does not contain a full path, the function creates the file in the Windows directory.

  - ### queryDosDevice

    public static final List<String> queryDosDevice(String lpszDeviceName, int maxTargetSize)
    Invokes the `Kernel32.QueryDosDevice(String, char[], int)` method and parses the result
    Parameters:
      `lpszDeviceName` - The device name
      `maxTargetSize` - The work buffer size to use for the query
    Returns:
      The parsed result

  - ### getVolumePathNamesForVolumeName

    public static final List<String> getVolumePathNamesForVolumeName(String lpszVolumeName)
    Invokes and parses the result of `Kernel32.GetVolumePathNamesForVolumeName(String, char[], int, IntByReference)`
    Parameters:
      `lpszVolumeName` - The volume name
    Returns:
      The parsed result
    Throws:
      `Win32Exception` - If failed to retrieve the required information

  - ### extractVolumeGUID

    public static final String extractVolumeGUID(String volumeGUIDPath)
    Parses and returns the pure GUID value of a volume name obtained from `Kernel32.FindFirstVolume(char[], int)` or `Kernel32.FindNextVolume(com.sun.jna.platform.win32.WinNT.HANDLE, char[], int)` calls
    Parameters:
      `volumeGUIDPath` - The volume GUID path as returned by one of the above mentioned calls
    Returns:
      The pure GUID value after stripping the "\\?\" prefix and removing the trailing backslash.
    Throws:
      `IllegalArgumentException` - if bad format encountered
    See Also:
      - Naming a Volume

  - ### QueryFullProcessImageName

    public static final String QueryFullProcessImageName(int pid, int dwFlags)
    This function retrieves the full path of the executable file of a given process identifier.
    Parameters:
      `pid` - Identifier for the running process
      `dwFlags` - 0 - The name should use the Win32 path format. 1(WinNT.PROCESS_NAME_NATIVE) - The name should use the native system path format.
    Returns:
      the full path of the process's executable file of null if failed. To get extended error information, call GetLastError.

  - ### QueryFullProcessImageName

    public static final String QueryFullProcessImageName(WinNT.HANDLE hProcess, int dwFlags)
    This function retrieves the full path of the executable file of a given process.
    Parameters:
      `hProcess` - Handle for the running process
      `dwFlags` - 0 - The name should use the Win32 path format. 1(WinNT.PROCESS_NAME_NATIVE) - The name should use the native system path format.
    Returns:
      the full path of the process's executable file of null if failed. To get extended error information, call GetLastError.

  - ### getResource

    public static byte[] getResource(String path, String type, String name)
    Gets the specified resource out of the specified executable file
    Parameters:
      `path` - The path to the executable file
      `type` - The type of the resource (either a type name or type ID is allowed)
      `name` - The name or ID of the resource
    Returns:
      The resource bytes, or null if no such resource exists.
    Throws:
      `IllegalStateException` - if the call to LockResource fails

  - ### getResourceNames

    public static Map<String,List<String>> getResourceNames(String path)
    Gets a list of all resources from the specified executable file
    Parameters:
      `path` - The path to the executable file
    Returns:
      A map of resource type name/ID => resources.
      A map key + a single list item + the path to the executable can be handed off to getResource() to actually get the resource.

  - ### getModules

    public static List<Tlhelp32.MODULEENTRY32W> getModules(int processID)
    Returns all the executable modules for a given process ID.
    Parameters:
      `processID` - The process ID to get executable modules for
    Returns:
      All the modules in the process.

  - ### expandEnvironmentStrings

    public static String expandEnvironmentStrings(String input)
    Expands environment-variable strings and replaces them with the values defined for the current user.
    Parameters:
      `input` - A string that contains one or more environment-variable strings in the form: %variableName%. For each such reference, the %variableName% portion is replaced with the current value of that environment variable.

      Case is ignored when looking up the environment-variable name. If the name is not found, the %variableName% portion is left unexpanded.

      Note that this function does not support all the features that Cmd.exe supports. For example, it does not support %variableName:str1=str2% or %variableName:~offset,length%.

    Returns:
      the replaced string
    Throws:
      `Win32Exception` - if an error occurs

  - ### getCurrentProcessPriority

    public static WinDef.DWORD getCurrentProcessPriority()
    Gets the priority class of the current process.
    Returns:
      The priority class of the current process.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### setCurrentProcessPriority

    public static void setCurrentProcessPriority(WinDef.DWORD dwPriorityClass)
    Sets the priority class for the current process.
    Parameters:
      `dwPriorityClass` - The priority class for the process.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### setCurrentProcessBackgroundMode

    public static void setCurrentProcessBackgroundMode(boolean enable)
    Enables or disables "background" processing mode for the current process
    Parameters:
      `enable` - If true, enables "background" processing mode, otherwise disables it.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### getCurrentThreadPriority

    public static int getCurrentThreadPriority()
    Gets the priority value of the current thread.
    Returns:
      The priority value of the current thread.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### setCurrentThreadPriority

    public static void setCurrentThreadPriority(int nPriority)
    Sets the priority value for the current thread.
    Parameters:
      `nPriority` - The priority value for the thread.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### setCurrentThreadBackgroundMode

    public static void setCurrentThreadBackgroundMode(boolean enable)
    Enables or disables "background" processing mode for the current thread
    Parameters:
      `enable` - If true, enables "background" processing mode, otherwise disables it.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### getProcessPriority

    public static WinDef.DWORD getProcessPriority(int pid)
    Gets the priority class of the specified process.
    Parameters:
      `pid` - Identifier for the running process.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### setProcessPriority

    public static void setProcessPriority(int pid, WinDef.DWORD dwPriorityClass)
    Sets the priority class for the specified process.
    Parameters:
      `pid` - Identifier for the running process.
      `dwPriorityClass` - The priority class for the process.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### getThreadPriority

    public static int getThreadPriority(int tid)
    Gets the priority value of the specified thread.
    Parameters:
      `tid` - Identifier for the running thread.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### setThreadPriority

    public static void setThreadPriority(int tid, int nPriority)
    Sets the priority value for the specified thread.
    Parameters:
      `tid` - Identifier for the running thread.
      `nPriority` - The priority value for the thread.
    Throws:
      `Win32Exception` - if an error occurs.

  - ### isValidPriorityClass

    public static boolean isValidPriorityClass(WinDef.DWORD dwPriorityClass)
    Test whether the given priority class is valid.

    Intentionally does not accept "background" processing mode flags!

    Parameters:
      `dwPriorityClass` - The priority value to test.
    Returns:
      Returns true, if and only if the given priority value was valid

  - ### isValidThreadPriority

    public static boolean isValidThreadPriority(int nPriority)
    Test whether the given thread priority is valid.

    Intentionally does not accept "background" processing mode flags!

    Parameters:
      `nPriority` - The priority value to test.
    Returns:
      Returns true, if and only if the given priority value was valid