Skip navigation links
JNA API 3.5.2-SNAPSHOT
com.sun.jna.platform.win32

Class Kernel32Util

    • Constructor Detail

      • Kernel32Util

        public Kernel32Util()
    • Method Detail

      • getComputerName

        public static java.lang.String getComputerName()
        Get current computer NetBIOS name.
        Returns:
        Netbios name.
      • formatMessageFromHR

        public static java.lang.String formatMessageFromHR(WinNT.HRESULT code)
        Format a message from an HRESULT.
        Parameters:
        code - HRESULT
        Returns:
        Formatted message.
      • formatMessageFromLastErrorCode

        public static java.lang.String formatMessageFromLastErrorCode(int code)
        Format a system message from an error code.
        Parameters:
        code - Error code, typically a result of GetLastError.
        Returns:
        Formatted message.
      • getTempPath

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

        public static void deleteFile(java.lang.String filename)
      • getLogicalDriveStrings

        public static java.lang.String[] getLogicalDriveStrings()
        Returns valid drives in the system.
        Returns:
        An array of valid drives.
      • getFileAttributes

        public static int getFileAttributes(java.lang.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(java.lang.String fileName)
                               throws java.io.FileNotFoundException
        Retrieves the result of GetFileType, provided the file exists.
        Throws:
        java.io.FileNotFoundException
      • getDriveType

        public static int getDriveType(java.lang.String rootName)
        Returns:
        One of the WinBase.DRIVE_* constants.
      • getEnvironmentVariable

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

        public static final int getPrivateProfileInt(java.lang.String appName,
                                                     java.lang.String keyName,
                                                     int defaultValue,
                                                     java.lang.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 java.lang.String getPrivateProfileString(java.lang.String lpAppName,
                                                                     java.lang.String lpKeyName,
                                                                     java.lang.String lpDefault,
                                                                     java.lang.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(java.lang.String appName,
                                                           java.lang.String keyName,
                                                           java.lang.String string,
                                                           java.lang.String fileName)
JNA API 3.5.2-SNAPSHOT

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