puppet 6.17.0-x64-mingw32 → 7.1.0-x64-mingw32

data/lib/puppet/ffi/windows/constants.rb

@@ -0,0 +1,404 @@
+require 'puppet/ffi/windows'
+
+module Puppet::FFI::Windows
+  module Constants
+    extend FFI::Library
+
+    FILE_ATTRIBUTE_READONLY      = 0x00000001
+    FILE_ATTRIBUTE_DIRECTORY     = 0x00000010
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa379607(v=vs.85).aspx
+    # The right to use the object for synchronization. This enables a thread to
+    # wait until the object is in the signaled state. Some object types do not
+    # support this access right.
+    SYNCHRONIZE                 = 0x100000
+    # The right to delete the object.
+    DELETE                      = 0x00010000
+    # The right to read the information in the object's security descriptor, not including the information in the system access control list (SACL).
+    # READ_CONTROL              = 0x00020000
+    # The right to modify the discretionary access control list (DACL) in the object's security descriptor.
+    WRITE_DAC                   = 0x00040000
+    # The right to change the owner in the object's security descriptor.
+    WRITE_OWNER                 = 0x00080000
+
+    # Combines DELETE, READ_CONTROL, WRITE_DAC, and WRITE_OWNER access.
+    STANDARD_RIGHTS_REQUIRED    = 0xf0000
+    # Currently defined to equal READ_CONTROL.
+    STANDARD_RIGHTS_READ        = 0x20000
+    # Currently defined to equal READ_CONTROL.
+    STANDARD_RIGHTS_WRITE       = 0x20000
+    # Currently defined to equal READ_CONTROL.
+    STANDARD_RIGHTS_EXECUTE     = 0x20000
+    # Combines DELETE, READ_CONTROL, WRITE_DAC, WRITE_OWNER, and SYNCHRONIZE access.
+    STANDARD_RIGHTS_ALL         = 0x1F0000
+    SPECIFIC_RIGHTS_ALL         = 0xFFFF
+
+    FILE_READ_DATA               = 1
+    FILE_WRITE_DATA              = 2
+    FILE_APPEND_DATA             = 4
+    FILE_READ_EA                 = 8
+    FILE_WRITE_EA                = 16
+    FILE_EXECUTE                 = 32
+    FILE_DELETE_CHILD            = 64
+    FILE_READ_ATTRIBUTES         = 128
+    FILE_WRITE_ATTRIBUTES        = 256
+
+    FILE_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0x1FF
+
+    FILE_GENERIC_READ =
+       STANDARD_RIGHTS_READ |
+       FILE_READ_DATA |
+       FILE_READ_ATTRIBUTES |
+       FILE_READ_EA |
+       SYNCHRONIZE
+
+    FILE_GENERIC_WRITE =
+       STANDARD_RIGHTS_WRITE |
+       FILE_WRITE_DATA |
+       FILE_WRITE_ATTRIBUTES |
+       FILE_WRITE_EA |
+       FILE_APPEND_DATA |
+       SYNCHRONIZE
+
+    FILE_GENERIC_EXECUTE =
+       STANDARD_RIGHTS_EXECUTE |
+       FILE_READ_ATTRIBUTES |
+       FILE_EXECUTE |
+       SYNCHRONIZE
+
+    REPLACEFILE_WRITE_THROUGH         = 0x1
+    REPLACEFILE_IGNORE_MERGE_ERRORS   = 0x2
+    REPLACEFILE_IGNORE_ACL_ERRORS     = 0x3
+
+    INVALID_FILE_ATTRIBUTES = 0xFFFFFFFF #define INVALID_FILE_ATTRIBUTES (DWORD (-1))
+
+    IO_REPARSE_TAG_MOUNT_POINT  = 0xA0000003
+    IO_REPARSE_TAG_HSM          = 0xC0000004
+    IO_REPARSE_TAG_HSM2         = 0x80000006
+    IO_REPARSE_TAG_SIS          = 0x80000007
+    IO_REPARSE_TAG_WIM          = 0x80000008
+    IO_REPARSE_TAG_CSV          = 0x80000009
+    IO_REPARSE_TAG_DFS          = 0x8000000A
+    IO_REPARSE_TAG_SYMLINK      = 0xA000000C
+    IO_REPARSE_TAG_DFSR         = 0x80000012
+    IO_REPARSE_TAG_DEDUP        = 0x80000013
+    IO_REPARSE_TAG_NFS          = 0x80000014
+
+    FILE_ATTRIBUTE_REPARSE_POINT = 0x400
+
+    GENERIC_READ                  = 0x80000000
+    GENERIC_WRITE                 = 0x40000000
+    GENERIC_EXECUTE               = 0x20000000
+    GENERIC_ALL                   = 0x10000000
+    METHOD_BUFFERED               = 0
+    FILE_SHARE_READ               = 1
+    FILE_SHARE_WRITE              = 2
+    OPEN_EXISTING                 = 3
+    FILE_DEVICE_FILE_SYSTEM       = 0x00000009
+    FILE_FLAG_OPEN_REPARSE_POINT  = 0x00200000
+    FILE_FLAG_BACKUP_SEMANTICS    = 0x02000000
+    SHGFI_DISPLAYNAME             = 0x000000200
+    SHGFI_PIDL                    = 0x000000008
+
+    ERROR_FILE_NOT_FOUND = 2
+    ERROR_PATH_NOT_FOUND = 3
+    ERROR_ALREADY_EXISTS = 183
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa364571(v=vs.85).aspx
+    FSCTL_GET_REPARSE_POINT = 0x900a8
+
+    MAXIMUM_REPARSE_DATA_BUFFER_SIZE = 16384
+
+    # Priority constants
+    # https://docs.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-setpriorityclass
+    ABOVE_NORMAL_PRIORITY_CLASS = 0x0008000
+    BELOW_NORMAL_PRIORITY_CLASS = 0x0004000
+    HIGH_PRIORITY_CLASS         = 0x0000080
+    IDLE_PRIORITY_CLASS         = 0x0000040
+    NORMAL_PRIORITY_CLASS       = 0x0000020
+    REALTIME_PRIORITY_CLASS     = 0x0000010
+
+    # Process Access Rights
+    # https://docs.microsoft.com/en-us/windows/win32/procthread/process-security-and-access-rights
+    PROCESS_TERMINATE         = 0x00000001
+    PROCESS_SET_INFORMATION   = 0x00000200
+    PROCESS_QUERY_INFORMATION = 0x00000400
+    PROCESS_ALL_ACCESS        = 0x001F0FFF
+    PROCESS_VM_READ           = 0x00000010
+
+    # Process creation flags
+    # https://docs.microsoft.com/en-us/windows/win32/procthread/process-creation-flags
+    CREATE_BREAKAWAY_FROM_JOB        = 0x01000000
+    CREATE_DEFAULT_ERROR_MODE        = 0x04000000
+    CREATE_NEW_CONSOLE               = 0x00000010
+    CREATE_NEW_PROCESS_GROUP         = 0x00000200
+    CREATE_NO_WINDOW                 = 0x08000000
+    CREATE_PROTECTED_PROCESS         = 0x00040000
+    CREATE_PRESERVE_CODE_AUTHZ_LEVEL = 0x02000000
+    CREATE_SEPARATE_WOW_VDM          = 0x00000800
+    CREATE_SHARED_WOW_VDM            = 0x00001000
+    CREATE_SUSPENDED                 = 0x00000004
+    CREATE_UNICODE_ENVIRONMENT       = 0x00000400
+    DEBUG_ONLY_THIS_PROCESS          = 0x00000002
+    DEBUG_PROCESS                    = 0x00000001
+    DETACHED_PROCESS                 = 0x00000008
+    INHERIT_PARENT_AFFINITY          = 0x00010000
+
+    # Logon options
+    LOGON_WITH_PROFILE        = 0x00000001
+
+    # STARTUPINFOA constants
+    # https://docs.microsoft.com/en-us/windows/win32/api/processthreadsapi/ns-processthreadsapi-startupinfoa
+    STARTF_USESTDHANDLES    = 0x00000100
+
+    # Miscellaneous
+    HANDLE_FLAG_INHERIT     = 0x00000001
+    SEM_FAILCRITICALERRORS  = 0x00000001
+    SEM_NOGPFAULTERRORBOX   = 0x00000002
+
+    # Error constants
+    INVALID_HANDLE_VALUE = FFI::Pointer.new(-1).address
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa379626(v=vs.85).aspx
+    TOKEN_INFORMATION_CLASS = enum(
+        :TokenUser, 1,
+        :TokenGroups,
+        :TokenPrivileges,
+        :TokenOwner,
+        :TokenPrimaryGroup,
+        :TokenDefaultDacl,
+        :TokenSource,
+        :TokenType,
+        :TokenImpersonationLevel,
+        :TokenStatistics,
+        :TokenRestrictedSids,
+        :TokenSessionId,
+        :TokenGroupsAndPrivileges,
+        :TokenSessionReference,
+        :TokenSandBoxInert,
+        :TokenAuditPolicy,
+        :TokenOrigin,
+        :TokenElevationType,
+        :TokenLinkedToken,
+        :TokenElevation,
+        :TokenHasRestrictions,
+        :TokenAccessInformation,
+        :TokenVirtualizationAllowed,
+        :TokenVirtualizationEnabled,
+        :TokenIntegrityLevel,
+        :TokenUIAccess,
+        :TokenMandatoryPolicy,
+        :TokenLogonSid,
+        :TokenIsAppContainer,
+        :TokenCapabilities,
+        :TokenAppContainerSid,
+        :TokenAppContainerNumber,
+        :TokenUserClaimAttributes,
+        :TokenDeviceClaimAttributes,
+        :TokenRestrictedUserClaimAttributes,
+        :TokenRestrictedDeviceClaimAttributes,
+        :TokenDeviceGroups,
+        :TokenRestrictedDeviceGroups,
+        :TokenSecurityAttributes,
+        :TokenIsRestricted,
+        :MaxTokenInfoClass
+    )
+
+    # Service error codes
+    # https://docs.microsoft.com/en-us/windows/desktop/debug/system-error-codes--1000-1299-
+    ERROR_SERVICE_DOES_NOT_EXIST = 0x00000424
+
+    # Service control codes
+    # https://docs.microsoft.com/en-us/windows/desktop/api/Winsvc/nf-winsvc-controlserviceexw
+    SERVICE_CONTROL_STOP                  = 0x00000001
+    SERVICE_CONTROL_PAUSE                 = 0x00000002
+    SERVICE_CONTROL_CONTINUE              = 0x00000003
+    SERVICE_CONTROL_INTERROGATE           = 0x00000004
+    SERVICE_CONTROL_SHUTDOWN              = 0x00000005
+    SERVICE_CONTROL_PARAMCHANGE           = 0x00000006
+    SERVICE_CONTROL_NETBINDADD            = 0x00000007
+    SERVICE_CONTROL_NETBINDREMOVE         = 0x00000008
+    SERVICE_CONTROL_NETBINDENABLE         = 0x00000009
+    SERVICE_CONTROL_NETBINDDISABLE        = 0x0000000A
+    SERVICE_CONTROL_DEVICEEVENT           = 0x0000000B
+    SERVICE_CONTROL_HARDWAREPROFILECHANGE = 0x0000000C
+    SERVICE_CONTROL_POWEREVENT            = 0x0000000D
+    SERVICE_CONTROL_SESSIONCHANGE         = 0x0000000E
+    SERVICE_CONTROL_PRESHUTDOWN           = 0x0000000F
+    SERVICE_CONTROL_TIMECHANGE            = 0x00000010
+    SERVICE_CONTROL_TRIGGEREVENT          = 0x00000020
+    SERVICE_CONTROL_SIGNALS               = {
+      SERVICE_CONTROL_STOP                  => :SERVICE_CONTROL_STOP,
+      SERVICE_CONTROL_PAUSE                 => :SERVICE_CONTROL_PAUSE,
+      SERVICE_CONTROL_CONTINUE              => :SERVICE_CONTROL_CONTINUE,
+      SERVICE_CONTROL_INTERROGATE           => :SERVICE_CONTROL_INTERROGATE,
+      SERVICE_CONTROL_SHUTDOWN              => :SERVICE_CONTROL_SHUTDOWN,
+      SERVICE_CONTROL_PARAMCHANGE           => :SERVICE_CONTROL_PARAMCHANGE,
+      SERVICE_CONTROL_NETBINDADD            => :SERVICE_CONTROL_NETBINDADD,
+      SERVICE_CONTROL_NETBINDREMOVE         => :SERVICE_CONTROL_NETBINDREMOVE,
+      SERVICE_CONTROL_NETBINDENABLE         => :SERVICE_CONTROL_NETBINDENABLE,
+      SERVICE_CONTROL_NETBINDDISABLE        => :SERVICE_CONTROL_NETBINDDISABLE,
+      SERVICE_CONTROL_DEVICEEVENT           => :SERVICE_CONTROL_DEVICEEVENT,
+      SERVICE_CONTROL_HARDWAREPROFILECHANGE => :SERVICE_CONTROL_HARDWAREPROFILECHANGE,
+      SERVICE_CONTROL_POWEREVENT            => :SERVICE_CONTROL_POWEREVENT,
+      SERVICE_CONTROL_SESSIONCHANGE         => :SERVICE_CONTROL_SESSIONCHANGE,
+      SERVICE_CONTROL_PRESHUTDOWN           => :SERVICE_CONTROL_PRESHUTDOWN,
+      SERVICE_CONTROL_TIMECHANGE            => :SERVICE_CONTROL_TIMECHANGE,
+      SERVICE_CONTROL_TRIGGEREVENT          => :SERVICE_CONTROL_TRIGGEREVENT
+    }
+
+    # Service start type codes
+    # https://docs.microsoft.com/en-us/windows/desktop/api/Winsvc/nf-winsvc-changeserviceconfigw
+    SERVICE_AUTO_START = 0x00000002
+    SERVICE_BOOT_START = 0x00000000
+    SERVICE_DEMAND_START = 0x00000003
+    SERVICE_DISABLED = 0x00000004
+    SERVICE_SYSTEM_START = 0x00000001
+    SERVICE_START_TYPES = {
+      SERVICE_AUTO_START => :SERVICE_AUTO_START,
+      SERVICE_BOOT_START => :SERVICE_BOOT_START,
+      SERVICE_DEMAND_START => :SERVICE_DEMAND_START,
+      SERVICE_DISABLED => :SERVICE_DISABLED,
+      SERVICE_SYSTEM_START => :SERVICE_SYSTEM_START,
+    }
+
+    # Service type codes
+    # https://docs.microsoft.com/en-us/windows/desktop/api/Winsvc/nf-winsvc-changeserviceconfigw
+    SERVICE_FILE_SYSTEM_DRIVER  = 0x00000002
+    SERVICE_KERNEL_DRIVER       = 0x00000001
+    SERVICE_WIN32_OWN_PROCESS   = 0x00000010
+    SERVICE_WIN32_SHARE_PROCESS = 0x00000020
+    SERVICE_USER_OWN_PROCESS    = 0x00000050
+    SERVICE_USER_SHARE_PROCESS  = 0x00000060
+    # Available only if service is also SERVICE_WIN32_OWN_PROCESS or SERVICE_WIN32_SHARE_PROCESS
+    SERVICE_INTERACTIVE_PROCESS = 0x00000100
+    ALL_SERVICE_TYPES =
+      SERVICE_FILE_SYSTEM_DRIVER |
+      SERVICE_KERNEL_DRIVER |
+      SERVICE_WIN32_OWN_PROCESS |
+      SERVICE_WIN32_SHARE_PROCESS
+
+    # Current state codes
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winsvc/ns-winsvc-_service_status_process
+    SERVICE_CONTINUE_PENDING = 0x00000005
+    SERVICE_PAUSE_PENDING    = 0x00000006
+    SERVICE_PAUSED           = 0x00000007
+    SERVICE_RUNNING          = 0x00000004
+    SERVICE_START_PENDING    = 0x00000002
+    SERVICE_STOP_PENDING     = 0x00000003
+    SERVICE_STOPPED          = 0x00000001
+    UNSAFE_PENDING_STATES    = [SERVICE_START_PENDING, SERVICE_STOP_PENDING]
+    FINAL_STATES             = {
+      SERVICE_CONTINUE_PENDING => SERVICE_RUNNING,
+      SERVICE_PAUSE_PENDING    => SERVICE_PAUSED,
+      SERVICE_START_PENDING    => SERVICE_RUNNING,
+      SERVICE_STOP_PENDING     => SERVICE_STOPPED
+    }
+    SERVICE_STATES           = {
+      SERVICE_CONTINUE_PENDING => :SERVICE_CONTINUE_PENDING,
+      SERVICE_PAUSE_PENDING => :SERVICE_PAUSE_PENDING,
+      SERVICE_PAUSED => :SERVICE_PAUSED,
+      SERVICE_RUNNING => :SERVICE_RUNNING,
+      SERVICE_START_PENDING => :SERVICE_START_PENDING,
+      SERVICE_STOP_PENDING => :SERVICE_STOP_PENDING,
+      SERVICE_STOPPED => :SERVICE_STOPPED,
+    }
+
+    # Service accepts control codes
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winsvc/ns-winsvc-_service_status_process
+    SERVICE_ACCEPT_STOP                  = 0x00000001
+    SERVICE_ACCEPT_PAUSE_CONTINUE        = 0x00000002
+    SERVICE_ACCEPT_SHUTDOWN              = 0x00000004
+    SERVICE_ACCEPT_PARAMCHANGE           = 0x00000008
+    SERVICE_ACCEPT_NETBINDCHANGE         = 0x00000010
+    SERVICE_ACCEPT_HARDWAREPROFILECHANGE = 0x00000020
+    SERVICE_ACCEPT_POWEREVENT            = 0x00000040
+    SERVICE_ACCEPT_SESSIONCHANGE         = 0x00000080
+    SERVICE_ACCEPT_PRESHUTDOWN           = 0x00000100
+    SERVICE_ACCEPT_TIMECHANGE            = 0x00000200
+    SERVICE_ACCEPT_TRIGGEREVENT          = 0x00000400
+    SERVICE_ACCEPT_USER_LOGOFF           = 0x00000800
+
+    # Service manager access codes
+    # https://docs.microsoft.com/en-us/windows/desktop/Services/service-security-and-access-rights
+    SC_MANAGER_CREATE_SERVICE     = 0x00000002
+    SC_MANAGER_CONNECT            = 0x00000001
+    SC_MANAGER_ENUMERATE_SERVICE  = 0x00000004
+    SC_MANAGER_LOCK               = 0x00000008
+    SC_MANAGER_MODIFY_BOOT_CONFIG = 0x00000020
+    SC_MANAGER_QUERY_LOCK_STATUS  = 0x00000010
+    SC_MANAGER_ALL_ACCESS         =
+      STANDARD_RIGHTS_REQUIRED |
+      SC_MANAGER_CREATE_SERVICE      |
+      SC_MANAGER_CONNECT             |
+      SC_MANAGER_ENUMERATE_SERVICE   |
+      SC_MANAGER_LOCK                |
+      SC_MANAGER_MODIFY_BOOT_CONFIG  |
+      SC_MANAGER_QUERY_LOCK_STATUS
+
+    # Service access codes
+    # https://docs.microsoft.com/en-us/windows/desktop/Services/service-security-and-access-rights
+    SERVICE_CHANGE_CONFIG        = 0x0002
+    SERVICE_ENUMERATE_DEPENDENTS = 0x0008
+    SERVICE_INTERROGATE          = 0x0080
+    SERVICE_PAUSE_CONTINUE       = 0x0040
+    SERVICE_QUERY_STATUS         = 0x0004
+    SERVICE_QUERY_CONFIG         = 0x0001
+    SERVICE_START                = 0x0010
+    SERVICE_STOP                 = 0x0020
+    SERVICE_USER_DEFINED_CONTROL = 0x0100
+    SERVICE_ALL_ACCESS           =
+      STANDARD_RIGHTS_REQUIRED |
+      SERVICE_CHANGE_CONFIG          |
+      SERVICE_ENUMERATE_DEPENDENTS   |
+      SERVICE_INTERROGATE            |
+      SERVICE_PAUSE_CONTINUE         |
+      SERVICE_QUERY_STATUS           |
+      SERVICE_QUERY_CONFIG           |
+      SERVICE_START                  |
+      SERVICE_STOP                   |
+      SERVICE_USER_DEFINED_CONTROL
+
+    # Service config codes
+    # From the windows 10 SDK:
+    # //
+    # // Value to indicate no change to an optional parameter
+    # //
+    # #define SERVICE_NO_CHANGE              0xffffffff
+    # https://docs.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-changeserviceconfig2w
+    SERVICE_CONFIG_DESCRIPTION              = 0x00000001
+    SERVICE_CONFIG_FAILURE_ACTIONS          = 0x00000002
+    SERVICE_CONFIG_DELAYED_AUTO_START_INFO  = 0x00000003
+    SERVICE_CONFIG_FAILURE_ACTIONS_FLAG     = 0x00000004
+    SERVICE_CONFIG_SERVICE_SID_INFO         = 0x00000005
+    SERVICE_CONFIG_REQUIRED_PRIVILEGES_INFO = 0x00000006
+    SERVICE_CONFIG_PRESHUTDOWN_INFO         = 0x00000007
+    SERVICE_CONFIG_TRIGGER_INFO             = 0x00000008
+    SERVICE_CONFIG_PREFERRED_NODE           = 0x00000009
+    SERVICE_CONFIG_LAUNCH_PROTECTED         = 0x00000012
+    SERVICE_NO_CHANGE                       = 0xffffffff
+    SERVICE_CONFIG_TYPES = {
+      SERVICE_CONFIG_DESCRIPTION => :SERVICE_CONFIG_DESCRIPTION,
+      SERVICE_CONFIG_FAILURE_ACTIONS => :SERVICE_CONFIG_FAILURE_ACTIONS,
+      SERVICE_CONFIG_DELAYED_AUTO_START_INFO => :SERVICE_CONFIG_DELAYED_AUTO_START_INFO,
+      SERVICE_CONFIG_FAILURE_ACTIONS_FLAG => :SERVICE_CONFIG_FAILURE_ACTIONS_FLAG,
+      SERVICE_CONFIG_SERVICE_SID_INFO => :SERVICE_CONFIG_SERVICE_SID_INFO,
+      SERVICE_CONFIG_REQUIRED_PRIVILEGES_INFO => :SERVICE_CONFIG_REQUIRED_PRIVILEGES_INFO,
+      SERVICE_CONFIG_PRESHUTDOWN_INFO => :SERVICE_CONFIG_PRESHUTDOWN_INFO,
+      SERVICE_CONFIG_TRIGGER_INFO => :SERVICE_CONFIG_TRIGGER_INFO,
+      SERVICE_CONFIG_PREFERRED_NODE => :SERVICE_CONFIG_PREFERRED_NODE,
+      SERVICE_CONFIG_LAUNCH_PROTECTED => :SERVICE_CONFIG_LAUNCH_PROTECTED,
+    }
+
+    # Service enum codes
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winsvc/nf-winsvc-enumservicesstatusexa
+    SERVICE_ACTIVE = 0x00000001
+    SERVICE_INACTIVE = 0x00000002
+    SERVICE_STATE_ALL =
+      SERVICE_ACTIVE |
+      SERVICE_INACTIVE
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winsvc/ns-winsvc-_enum_service_status_processw
+    SERVICENAME_MAX = 256
+  end
+end

data/lib/puppet/ffi/windows/functions.rb

@@ -0,0 +1,628 @@
+require 'puppet/ffi/windows'
+
+module Puppet::FFI::Windows
+  module Functions
+
+    extend FFI::Library
+    include Puppet::FFI::Windows::Constants
+
+    ffi_convention :stdcall
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/handleapi/nf-handleapi-sethandleinformation
+    # BOOL SetHandleInformation(
+    #   HANDLE hObject,
+    #   DWORD  dwMask,
+    #   DWORD  dwFlags
+    # );
+    ffi_lib :kernel32
+    attach_function_private :SetHandleInformation, [:handle, :dword, :dword], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/errhandlingapi/nf-errhandlingapi-seterrormode
+    # UINT SetErrorMode(
+    #   UINT uMode
+    # );
+    ffi_lib :kernel32
+    attach_function_private :SetErrorMode, [:uint], :uint
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-createprocessw
+    # BOOL CreateProcessW(
+    #   LPCWSTR               lpApplicationName,
+    #   LPWSTR                lpCommandLine,
+    #   LPSECURITY_ATTRIBUTES lpProcessAttributes,
+    #   LPSECURITY_ATTRIBUTES lpThreadAttributes,
+    #   BOOL                  bInheritHandles,
+    #   DWORD                 dwCreationFlags,
+    #   LPVOID                lpEnvironment,
+    #   LPCWSTR               lpCurrentDirectory,
+    #   LPSTARTUPINFOW        lpStartupInfo,
+    #   LPPROCESS_INFORMATION lpProcessInformation
+    # );
+    ffi_lib :kernel32
+    attach_function_private :CreateProcessW,
+      [:lpcwstr, :lpwstr, :pointer, :pointer, :win32_bool,
+       :dword, :lpvoid, :lpcwstr, :pointer, :pointer], :bool
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-openprocess
+    # HANDLE OpenProcess(
+    #   DWORD dwDesiredAccess,
+    #   BOOL  bInheritHandle,
+    #   DWORD dwProcessId
+    # );
+    ffi_lib :kernel32
+    attach_function_private :OpenProcess, [:dword, :win32_bool, :dword], :handle
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-setpriorityclass
+    # BOOL SetPriorityClass(
+    #   HANDLE hProcess,
+    #   DWORD  dwPriorityClass
+    # );
+    ffi_lib :kernel32
+    attach_function_private :SetPriorityClass, [:handle, :dword], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-createprocesswithlogonw
+    # BOOL CreateProcessWithLogonW(
+    #   LPCWSTR               lpUsername,
+    #   LPCWSTR               lpDomain,
+    #   LPCWSTR               lpPassword,
+    #   DWORD                 dwLogonFlags,
+    #   LPCWSTR               lpApplicationName,
+    #   LPWSTR                lpCommandLine,
+    #   DWORD                 dwCreationFlags,
+    #   LPVOID                lpEnvironment,
+    #   LPCWSTR               lpCurrentDirectory,
+    #   LPSTARTUPINFOW        lpStartupInfo,
+    #   LPPROCESS_INFORMATION lpProcessInformation
+    # );
+    ffi_lib :advapi32
+    attach_function_private :CreateProcessWithLogonW,
+      [:lpcwstr, :lpcwstr, :lpcwstr, :dword, :lpcwstr, :lpwstr,
+       :dword, :lpvoid, :lpcwstr, :pointer, :pointer], :bool
+
+    # https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/get-osfhandle?view=vs-2019
+    # intptr_t _get_osfhandle(
+    #    int fd
+    # );
+    ffi_lib FFI::Library::LIBC
+    attach_function_private :get_osfhandle, :_get_osfhandle, [:int], :intptr_t
+
+    begin
+      # https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/get-errno?view=vs-2019
+      # errno_t _get_errno(
+      #    int * pValue
+      # );
+      attach_function_private :get_errno, :_get_errno, [:pointer], :int
+    rescue FFI::NotFoundError
+      # Do nothing, Windows XP or earlier.
+    end
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/ms687032(v=vs.85).aspx
+    # DWORD WINAPI WaitForSingleObject(
+    #   _In_  HANDLE hHandle,
+    #   _In_  DWORD dwMilliseconds
+    # );
+    ffi_lib :kernel32
+    attach_function_private :WaitForSingleObject,
+      [:handle, :dword], :dword, :blocking => true
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-waitformultipleobjects
+    #   DWORD WaitForMultipleObjects(
+    #   DWORD        nCount,
+    #   const HANDLE *lpHandles,
+    #   BOOL         bWaitAll,
+    #   DWORD        dwMilliseconds
+    # );
+    ffi_lib :kernel32
+    attach_function_private :WaitForMultipleObjects,
+      [:dword, :phandle, :win32_bool, :dword], :dword
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-createeventw
+    # HANDLE CreateEventW(
+    #   LPSECURITY_ATTRIBUTES lpEventAttributes,
+    #   BOOL                  bManualReset,
+    #   BOOL                  bInitialState,
+    #   LPCWSTR               lpName
+    # );
+    ffi_lib :kernel32
+    attach_function_private :CreateEventW,
+      [:pointer, :win32_bool, :win32_bool, :lpcwstr], :handle
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-createthread
+    # HANDLE CreateThread(
+    #   LPSECURITY_ATTRIBUTES   lpThreadAttributes,
+    #   SIZE_T                  dwStackSize,
+    #   LPTHREAD_START_ROUTINE  lpStartAddress,
+    #   __drv_aliasesMem LPVOID lpParameter,
+    #   DWORD                   dwCreationFlags,
+    #   LPDWORD                 lpThreadId
+    # );
+    ffi_lib :kernel32
+    attach_function_private :CreateThread,
+      [:pointer, :size_t, :pointer, :lpvoid, :dword, :lpdword], :handle, :blocking => true
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-setevent
+    # BOOL SetEvent(
+    #   HANDLE hEvent
+    # );
+    ffi_lib :kernel32
+    attach_function_private :SetEvent,
+      [:handle], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/ms683189(v=vs.85).aspx
+    # BOOL WINAPI GetExitCodeProcess(
+    #   _In_   HANDLE hProcess,
+    #   _Out_  LPDWORD lpExitCode
+    # );
+    ffi_lib :kernel32
+    attach_function_private :GetExitCodeProcess,
+      [:handle, :lpdword], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/ms683179(v=vs.85).aspx
+    # HANDLE WINAPI GetCurrentProcess(void);
+    ffi_lib :kernel32
+    attach_function_private :GetCurrentProcess, [], :handle
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/ms683187(v=vs.85).aspx
+    # LPTCH GetEnvironmentStrings(void);
+    ffi_lib :kernel32
+    attach_function_private :GetEnvironmentStringsW, [], :pointer
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/ms683151(v=vs.85).aspx
+    # BOOL FreeEnvironmentStrings(
+    #   _In_ LPTCH lpszEnvironmentBlock
+    # );
+    ffi_lib :kernel32
+    attach_function_private :FreeEnvironmentStringsW,
+      [:pointer], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/ms686206(v=vs.85).aspx
+    # BOOL WINAPI SetEnvironmentVariableW(
+    #     _In_     LPCTSTR lpName,
+    #     _In_opt_ LPCTSTR lpValue
+    #   );
+    ffi_lib :kernel32
+    attach_function_private :SetEnvironmentVariableW,
+      [:lpcwstr, :lpcwstr], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/ms684320(v=vs.85).aspx
+    # HANDLE WINAPI OpenProcess(
+    #   _In_   DWORD DesiredAccess,
+    #   _In_   BOOL InheritHandle,
+    #   _In_   DWORD ProcessId
+    # );
+    ffi_lib :kernel32
+    attach_function_private :OpenProcess,
+      [:dword, :win32_bool, :dword], :handle
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa379295(v=vs.85).aspx
+    # BOOL WINAPI OpenProcessToken(
+    #   _In_   HANDLE ProcessHandle,
+    #   _In_   DWORD DesiredAccess,
+    #   _Out_  PHANDLE TokenHandle
+    # );
+    ffi_lib :advapi32
+    attach_function_private :OpenProcessToken,
+      [:handle, :dword, :phandle], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-queryfullprocessimagenamew
+    # BOOL WINAPI QueryFullProcessImageName(
+    #   _In_   HANDLE hProcess,
+    #   _In_   DWORD dwFlags,
+    #   _Out_  LPWSTR lpExeName,
+    #   _In_   PDWORD lpdwSize,
+    # );
+    ffi_lib :kernel32
+    attach_function_private :QueryFullProcessImageNameW,
+      [:handle, :dword, :lpwstr, :pdword], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/Windows/desktop/aa379180(v=vs.85).aspx
+    # BOOL WINAPI LookupPrivilegeValue(
+    #   _In_opt_  LPCTSTR lpSystemName,
+    #   _In_      LPCTSTR lpName,
+    #   _Out_     PLUID lpLuid
+    # );
+    ffi_lib :advapi32
+    attach_function_private :LookupPrivilegeValueW,
+      [:lpcwstr, :lpcwstr, :pointer], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa446671(v=vs.85).aspx
+    # BOOL WINAPI GetTokenInformation(
+    #   _In_       HANDLE TokenHandle,
+    #   _In_       TOKEN_INFORMATION_CLASS TokenInformationClass,
+    #   _Out_opt_  LPVOID TokenInformation,
+    #   _In_       DWORD TokenInformationLength,
+    #   _Out_      PDWORD ReturnLength
+    # );
+    ffi_lib :advapi32
+    attach_function_private :GetTokenInformation,
+      [:handle, TOKEN_INFORMATION_CLASS, :lpvoid, :dword, :pdword ], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/ms724451(v=vs.85).aspx
+    # BOOL WINAPI GetVersionEx(
+    #   _Inout_  LPOSVERSIONINFO lpVersionInfo
+    # );
+    ffi_lib :kernel32
+    attach_function_private :GetVersionExW,
+      [:pointer], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/dd318123(v=vs.85).aspx
+    # LANGID GetSystemDefaultUILanguage(void);
+    ffi_lib :kernel32
+    attach_function_private :GetSystemDefaultUILanguage, [], :word
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/Winsvc/nf-winsvc-openscmanagerw
+    # SC_HANDLE OpenSCManagerW(
+    #   LPCWSTR lpMachineName,
+    #   LPCWSTR lpDatabaseName,
+    #   DWORD   dwDesiredAccess
+    # );
+    ffi_lib :advapi32
+    attach_function_private :OpenSCManagerW,
+      [:lpcwstr, :lpcwstr, :dword], :handle
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/Winsvc/nf-winsvc-openservicew
+    # SC_HANDLE OpenServiceW(
+    #   SC_HANDLE hSCManager,
+    #   LPCWSTR   lpServiceName,
+    #   DWORD     dwDesiredAccess
+    # );
+    ffi_lib :advapi32
+    attach_function_private :OpenServiceW,
+      [:handle, :lpcwstr, :dword], :handle
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/Winsvc/nf-winsvc-closeservicehandle
+    # BOOL CloseServiceHandle(
+    #   SC_HANDLE hSCObject
+    # );
+    ffi_lib :advapi32
+    attach_function_private :CloseServiceHandle,
+      [:handle], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winsvc/nf-winsvc-queryservicestatusex
+    # BOOL QueryServiceStatusEx(
+    #   SC_HANDLE      hService,
+    #   SC_STATUS_TYPE InfoLevel,
+    #   LPBYTE         lpBuffer,
+    #   DWORD          cbBufSize,
+    #   LPDWORD        pcbBytesNeeded
+    # );
+    SC_STATUS_TYPE = enum(
+      :SC_STATUS_PROCESS_INFO, 0,
+    )
+    ffi_lib :advapi32
+    attach_function_private :QueryServiceStatusEx,
+      [:handle, SC_STATUS_TYPE, :lpbyte, :dword, :lpdword], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/Winsvc/nf-winsvc-queryserviceconfigw
+    # BOOL QueryServiceConfigW(
+    #   SC_HANDLE               hService,
+    #   LPQUERY_SERVICE_CONFIGW lpServiceConfig,
+    #   DWORD                   cbBufSize,
+    #   LPDWORD                 pcbBytesNeeded
+    # );
+    ffi_lib :advapi32
+    attach_function_private :QueryServiceConfigW,
+      [:handle, :lpbyte, :dword, :lpdword], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-queryserviceconfig2w
+    # BOOL QueryServiceConfig2W(
+    #   SC_HANDLE hService,
+    #   DWORD     dwInfoLevel,
+    #   LPBYTE    lpBuffer,
+    #   DWORD     cbBufSize,
+    #   LPDWORD   pcbBytesNeeded
+    # );
+    ffi_lib :advapi32
+    attach_function_private :QueryServiceConfig2W,
+      [:handle, :dword, :lpbyte, :dword, :lpdword], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/Winsvc/nf-winsvc-startservicew
+    # BOOL StartServiceW(
+    #   SC_HANDLE hService,
+    #   DWORD     dwNumServiceArgs,
+    #   LPCWSTR   *lpServiceArgVectors
+    # );
+    ffi_lib :advapi32
+    attach_function_private :StartServiceW,
+      [:handle, :dword, :pointer], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-startservicectrldispatcherw
+    # BOOL StartServiceCtrlDispatcherW(
+    #   const SERVICE_TABLE_ENTRYW *lpServiceStartTable
+    # );
+    ffi_lib :advapi32
+    attach_function_private :StartServiceCtrlDispatcherW,
+      [:pointer], :win32_bool, :blocking => true
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-setservicestatus
+    # BOOL SetServiceStatus(
+    #   SERVICE_STATUS_HANDLE hServiceStatus,
+    #   LPSERVICE_STATUS      lpServiceStatus
+    # );
+    ffi_lib :advapi32
+    attach_function_private :SetServiceStatus,
+      [:handle, :pointer], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winsvc/nf-winsvc-controlservice
+    # BOOL ControlService(
+    #   SC_HANDLE        hService,
+    #   DWORD            dwControl,
+    #   LPSERVICE_STATUS lpServiceStatus
+    # );
+    ffi_lib :advapi32
+    attach_function_private :ControlService,
+      [:handle, :dword, :pointer], :win32_bool
+
+    #   DWORD LphandlerFunctionEx(
+    #   DWORD dwControl,
+    #   DWORD dwEventType,
+    #   LPVOID lpEventData,
+    #   LPVOID lpContext
+    # )
+    callback :handler_ex, [:dword, :dword, :lpvoid, :lpvoid], :void
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-registerservicectrlhandlerexw
+    # SERVICE_STATUS_HANDLE RegisterServiceCtrlHandlerExW(
+    #   LPCWSTR               lpServiceName,
+    #   LPHANDLER_FUNCTION_EX lpHandlerProc,
+    #   LPVOID                lpContext
+    # );
+    ffi_lib :advapi32
+    attach_function_private :RegisterServiceCtrlHandlerExW,
+      [:lpcwstr, :handler_ex, :lpvoid], :handle
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winsvc/nf-winsvc-changeserviceconfigw
+    # BOOL ChangeServiceConfigW(
+    #   SC_HANDLE hService,
+    #   DWORD     dwServiceType,
+    #   DWORD     dwStartType,
+    #   DWORD     dwErrorControl,
+    #   LPCWSTR   lpBinaryPathName,
+    #   LPCWSTR   lpLoadOrderGroup,
+    #   LPDWORD   lpdwTagId,
+    #   LPCWSTR   lpDependencies,
+    #   LPCWSTR   lpServiceStartName,
+    #   LPCWSTR   lpPassword,
+    #   LPCWSTR   lpDisplayName
+    # );
+    ffi_lib :advapi32
+    attach_function_private :ChangeServiceConfigW,
+      [
+        :handle,
+        :dword,
+        :dword,
+        :dword,
+        :lpcwstr,
+        :lpcwstr,
+        :lpdword,
+        :lpcwstr,
+        :lpcwstr,
+        :lpcwstr,
+        :lpcwstr
+      ], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-changeserviceconfig2w
+    # BOOL ChangeServiceConfig2W(
+    #   SC_HANDLE hService,
+    #   DWORD     dwInfoLevel,
+    #   LPVOID    lpInfo
+    # );
+    ffi_lib :advapi32
+    attach_function_private :ChangeServiceConfig2W,
+      [:handle, :dword, :lpvoid], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/desktop/api/winsvc/nf-winsvc-enumservicesstatusexw
+    # BOOL EnumServicesStatusExW(
+    #   SC_HANDLE    hSCManager,
+    #   SC_ENUM_TYPE InfoLevel,
+    #   DWORD        dwServiceType,
+    #   DWORD        dwServiceState,
+    #   LPBYTE       lpServices,
+    #   DWORD        cbBufSize,
+    #   LPDWORD      pcbBytesNeeded,
+    #   LPDWORD      lpServicesReturned,
+    #   LPDWORD      lpResumeHandle,
+    #   LPCWSTR      pszGroupName
+    # );
+    SC_ENUM_TYPE = enum(
+      :SC_ENUM_PROCESS_INFO, 0,
+    )
+    ffi_lib :advapi32
+    attach_function_private :EnumServicesStatusExW,
+      [
+        :handle,
+        SC_ENUM_TYPE,
+        :dword,
+        :dword,
+        :lpbyte,
+        :dword,
+        :lpdword,
+        :lpdword,
+        :lpdword,
+        :lpcwstr
+      ], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa365512(v=vs.85).aspx
+    # BOOL WINAPI ReplaceFile(
+    #   _In_        LPCTSTR lpReplacedFileName,
+    #   _In_        LPCTSTR lpReplacementFileName,
+    #   _In_opt_    LPCTSTR lpBackupFileName,
+    #   _In_        DWORD dwReplaceFlags - 0x1 REPLACEFILE_WRITE_THROUGH,
+    #                                      0x2 REPLACEFILE_IGNORE_MERGE_ERRORS,
+    #                                      0x4 REPLACEFILE_IGNORE_ACL_ERRORS
+    #   _Reserved_  LPVOID lpExclude,
+    #   _Reserved_  LPVOID lpReserved
+    # );
+    ffi_lib :kernel32
+    attach_function_private :ReplaceFileW,
+      [:lpcwstr, :lpcwstr, :lpcwstr, :dword, :lpvoid, :lpvoid], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa365240(v=vs.85).aspx
+    # BOOL WINAPI MoveFileEx(
+    #   _In_      LPCTSTR lpExistingFileName,
+    #   _In_opt_  LPCTSTR lpNewFileName,
+    #   _In_      DWORD dwFlags
+    # );
+    ffi_lib :kernel32
+    attach_function_private :MoveFileExW,
+      [:lpcwstr, :lpcwstr, :dword], :win32_bool
+
+    # BOOLEAN WINAPI CreateSymbolicLink(
+    #   _In_  LPTSTR lpSymlinkFileName, - symbolic link to be created
+    #   _In_  LPTSTR lpTargetFileName, - name of target for symbolic link
+    #   _In_  DWORD dwFlags - 0x0 target is a file, 0x1 target is a directory
+    # );
+    # rescue on Windows < 6.0 so that code doesn't explode
+    begin
+      ffi_lib :kernel32
+      attach_function_private :CreateSymbolicLinkW,
+        [:lpwstr, :lpwstr, :dword], :boolean
+    rescue LoadError
+    end
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-getcurrentdirectory
+    # DWORD GetCurrentDirectory(
+    #   DWORD  nBufferLength,
+    #   LPTSTR lpBuffer
+    # );
+    ffi_lib :kernel32
+    attach_function_private :GetCurrentDirectoryW,
+      [:dword, :lpwstr], :dword
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa364944(v=vs.85).aspx
+    # DWORD WINAPI GetFileAttributes(
+    #   _In_  LPCTSTR lpFileName
+    # );
+    ffi_lib :kernel32
+    attach_function_private :GetFileAttributesW,
+      [:lpcwstr], :dword
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa365535(v=vs.85).aspx
+    # BOOL WINAPI SetFileAttributes(
+    #   _In_  LPCTSTR lpFileName,
+    #   _In_  DWORD dwFileAttributes
+    # );
+    ffi_lib :kernel32
+    attach_function_private :SetFileAttributesW,
+      [:lpcwstr, :dword], :win32_bool
+
+    # HANDLE WINAPI CreateFile(
+    #   _In_      LPCTSTR lpFileName,
+    #   _In_      DWORD dwDesiredAccess,
+    #   _In_      DWORD dwShareMode,
+    #   _In_opt_  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
+    #   _In_      DWORD dwCreationDisposition,
+    #   _In_      DWORD dwFlagsAndAttributes,
+    #   _In_opt_  HANDLE hTemplateFile
+    # );
+    ffi_lib :kernel32
+    attach_function_private :CreateFileW,
+      [:lpcwstr, :dword, :dword, :pointer, :dword, :dword, :handle], :handle
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-createdirectoryw
+    # BOOL CreateDirectoryW(
+    #   LPCWSTR               lpPathName,
+    #   LPSECURITY_ATTRIBUTES lpSecurityAttributes
+    # );
+    ffi_lib :kernel32
+    attach_function_private :CreateDirectoryW,
+      [:lpcwstr, :pointer], :win32_bool
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-removedirectoryw
+    # BOOL RemoveDirectoryW(
+    #   LPCWSTR lpPathName
+    # );
+    ffi_lib :kernel32
+    attach_function_private :RemoveDirectoryW,
+      [:lpcwstr], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa363216(v=vs.85).aspx
+    # BOOL WINAPI DeviceIoControl(
+    #   _In_         HANDLE hDevice,
+    #   _In_         DWORD dwIoControlCode,
+    #   _In_opt_     LPVOID lpInBuffer,
+    #   _In_         DWORD nInBufferSize,
+    #   _Out_opt_    LPVOID lpOutBuffer,
+    #   _In_         DWORD nOutBufferSize,
+    #   _Out_opt_    LPDWORD lpBytesReturned,
+    #   _Inout_opt_  LPOVERLAPPED lpOverlapped
+    # );
+    ffi_lib :kernel32
+    attach_function_private :DeviceIoControl,
+      [:handle, :dword, :lpvoid, :dword, :lpvoid, :dword, :lpdword, :pointer], :win32_bool
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa364980(v=vs.85).aspx
+    # DWORD WINAPI GetLongPathName(
+    #   _In_  LPCTSTR lpszShortPath,
+    #   _Out_ LPTSTR  lpszLongPath,
+    #   _In_  DWORD   cchBuffer
+    # );
+    ffi_lib :kernel32
+    attach_function_private :GetLongPathNameW,
+      [:lpcwstr, :lpwstr, :dword], :dword
+
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/aa364989(v=vs.85).aspx
+    # DWORD WINAPI GetShortPathName(
+    #   _In_  LPCTSTR lpszLongPath,
+    #   _Out_ LPTSTR  lpszShortPath,
+    #   _In_  DWORD   cchBuffer
+    # );
+    ffi_lib :kernel32
+    attach_function_private :GetShortPathNameW,
+      [:lpcwstr, :lpwstr, :dword], :dword
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-getfullpathnamew
+    # DWORD GetFullPathNameW(
+    #   LPCWSTR lpFileName,
+    #   DWORD   nBufferLength,
+    #   LPWSTR  lpBuffer,
+    #   LPWSTR  *lpFilePart
+    # );
+    ffi_lib :kernel32
+    attach_function_private :GetFullPathNameW,
+      [:lpcwstr, :dword, :lpwstr, :pointer], :dword
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetfolderpathw
+    # SHFOLDERAPI SHGetFolderPathW(
+    #   HWND   hwnd,
+    #   int    csidl,
+    #   HANDLE hToken,
+    #   DWORD  dwFlags,
+    #   LPWSTR pszPath
+    # );
+    ffi_lib :shell32
+    attach_function_private :SHGetFolderPathW,
+      [:hwnd, :int, :handle, :dword, :lpwstr], :dword
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetfolderlocation
+    # SHSTDAPI SHGetFolderLocation(
+    #   HWND             hwnd,
+    #   int              csidl,
+    #   HANDLE           hToken,
+    #   DWORD            dwFlags,
+    #   PIDLIST_ABSOLUTE *ppidl
+    # );
+    ffi_lib :shell32
+    attach_function_private :SHGetFolderLocation,
+      [:hwnd, :int, :handle, :dword, :pointer], :dword
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-shgetfileinfoa
+    # DWORD_PTR SHGetFileInfoA(
+    #   LPCSTR      pszPath,
+    #   DWORD       dwFileAttributes,
+    #   SHFILEINFOA *psfi,
+    #   UINT        cbFileInfo,
+    #   UINT        uFlags
+    # );
+    ffi_lib :shell32
+    attach_function_private :SHGetFileInfo,
+      [:dword, :dword, :pointer, :uint, :uint], :dword
+
+    # https://docs.microsoft.com/en-us/windows/win32/api/shlwapi/nf-shlwapi-pathisdirectoryemptyw
+    # BOOL PathIsDirectoryEmptyW(
+    #   LPCWSTR pszPath
+    # );
+    ffi_lib :shlwapi
+    attach_function_private :PathIsDirectoryEmptyW,
+      [:lpcwstr], :win32_bool
+  end
+end