debugpy 1.8.5__zip → 1.8.7__zip

{debugpy-1.8.5 → debugpy-1.8.7}/src/debugpy/_vendored/pydevd/pydevd_attach_to_process/winappdbg/win32/shell32.py

@@ -41,118 +41,118 @@ __revision__ = "$Id$"
 from winappdbg.win32.defines import *
 from winappdbg.win32.kernel32 import LocalFree
 
-#==============================================================================
+# ==============================================================================
 # This is used later on to calculate the list of exported symbols.
 _all = None
 _all = set(vars().keys())
-#==============================================================================
-
-#--- Constants ----------------------------------------------------------------
-
-SEE_MASK_DEFAULT            = 0x00000000
-SEE_MASK_CLASSNAME          = 0x00000001
-SEE_MASK_CLASSKEY           = 0x00000003
-SEE_MASK_IDLIST             = 0x00000004
-SEE_MASK_INVOKEIDLIST       = 0x0000000C
-SEE_MASK_ICON               = 0x00000010
-SEE_MASK_HOTKEY             = 0x00000020
-SEE_MASK_NOCLOSEPROCESS     = 0x00000040
-SEE_MASK_CONNECTNETDRV      = 0x00000080
-SEE_MASK_NOASYNC            = 0x00000100
-SEE_MASK_DOENVSUBST         = 0x00000200
-SEE_MASK_FLAG_NO_UI         = 0x00000400
-SEE_MASK_UNICODE            = 0x00004000
-SEE_MASK_NO_CONSOLE         = 0x00008000
-SEE_MASK_ASYNCOK            = 0x00100000
-SEE_MASK_HMONITOR           = 0x00200000
-SEE_MASK_NOZONECHECKS       = 0x00800000
-SEE_MASK_WAITFORINPUTIDLE   = 0x02000000
-SEE_MASK_FLAG_LOG_USAGE     = 0x04000000
-
-SE_ERR_FNF              = 2
-SE_ERR_PNF              = 3
-SE_ERR_ACCESSDENIED     = 5
-SE_ERR_OOM              = 8
-SE_ERR_DLLNOTFOUND      = 32
-SE_ERR_SHARE            = 26
-SE_ERR_ASSOCINCOMPLETE  = 27
-SE_ERR_DDETIMEOUT       = 28
-SE_ERR_DDEFAIL          = 29
-SE_ERR_DDEBUSY          = 30
-SE_ERR_NOASSOC          = 31
+# ==============================================================================
+
+# --- Constants ----------------------------------------------------------------
+
+SEE_MASK_DEFAULT = 0x00000000
+SEE_MASK_CLASSNAME = 0x00000001
+SEE_MASK_CLASSKEY = 0x00000003
+SEE_MASK_IDLIST = 0x00000004
+SEE_MASK_INVOKEIDLIST = 0x0000000C
+SEE_MASK_ICON = 0x00000010
+SEE_MASK_HOTKEY = 0x00000020
+SEE_MASK_NOCLOSEPROCESS = 0x00000040
+SEE_MASK_CONNECTNETDRV = 0x00000080
+SEE_MASK_NOASYNC = 0x00000100
+SEE_MASK_DOENVSUBST = 0x00000200
+SEE_MASK_FLAG_NO_UI = 0x00000400
+SEE_MASK_UNICODE = 0x00004000
+SEE_MASK_NO_CONSOLE = 0x00008000
+SEE_MASK_ASYNCOK = 0x00100000
+SEE_MASK_HMONITOR = 0x00200000
+SEE_MASK_NOZONECHECKS = 0x00800000
+SEE_MASK_WAITFORINPUTIDLE = 0x02000000
+SEE_MASK_FLAG_LOG_USAGE = 0x04000000
+
+SE_ERR_FNF = 2
+SE_ERR_PNF = 3
+SE_ERR_ACCESSDENIED = 5
+SE_ERR_OOM = 8
+SE_ERR_DLLNOTFOUND = 32
+SE_ERR_SHARE = 26
+SE_ERR_ASSOCINCOMPLETE = 27
+SE_ERR_DDETIMEOUT = 28
+SE_ERR_DDEFAIL = 29
+SE_ERR_DDEBUSY = 30
+SE_ERR_NOASSOC = 31
 
 SHGFP_TYPE_CURRENT = 0
 SHGFP_TYPE_DEFAULT = 1
 
-CSIDL_DESKTOP                   = 0x0000
-CSIDL_INTERNET                  = 0x0001
-CSIDL_PROGRAMS                  = 0x0002
-CSIDL_CONTROLS                  = 0x0003
-CSIDL_PRINTERS                  = 0x0004
-CSIDL_PERSONAL                  = 0x0005
-CSIDL_FAVORITES                 = 0x0006
-CSIDL_STARTUP                   = 0x0007
-CSIDL_RECENT                    = 0x0008
-CSIDL_SENDTO                    = 0x0009
-CSIDL_BITBUCKET                 = 0x000a
-CSIDL_STARTMENU                 = 0x000b
-CSIDL_MYDOCUMENTS               = CSIDL_PERSONAL
-CSIDL_MYMUSIC                   = 0x000d
-CSIDL_MYVIDEO                   = 0x000e
-CSIDL_DESKTOPDIRECTORY          = 0x0010
-CSIDL_DRIVES                    = 0x0011
-CSIDL_NETWORK                   = 0x0012
-CSIDL_NETHOOD                   = 0x0013
-CSIDL_FONTS                     = 0x0014
-CSIDL_TEMPLATES                 = 0x0015
-CSIDL_COMMON_STARTMENU          = 0x0016
-CSIDL_COMMON_PROGRAMS           = 0x0017
-CSIDL_COMMON_STARTUP            = 0x0018
-CSIDL_COMMON_DESKTOPDIRECTORY   = 0x0019
-CSIDL_APPDATA                   = 0x001a
-CSIDL_PRINTHOOD                 = 0x001b
-CSIDL_LOCAL_APPDATA             = 0x001c
-CSIDL_ALTSTARTUP                = 0x001d
-CSIDL_COMMON_ALTSTARTUP         = 0x001e
-CSIDL_COMMON_FAVORITES          = 0x001f
-CSIDL_INTERNET_CACHE            = 0x0020
-CSIDL_COOKIES                   = 0x0021
-CSIDL_HISTORY                   = 0x0022
-CSIDL_COMMON_APPDATA            = 0x0023
-CSIDL_WINDOWS                   = 0x0024
-CSIDL_SYSTEM                    = 0x0025
-CSIDL_PROGRAM_FILES             = 0x0026
-CSIDL_MYPICTURES                = 0x0027
-CSIDL_PROFILE                   = 0x0028
-CSIDL_SYSTEMX86                 = 0x0029
-CSIDL_PROGRAM_FILESX86          = 0x002a
-CSIDL_PROGRAM_FILES_COMMON      = 0x002b
-CSIDL_PROGRAM_FILES_COMMONX86   = 0x002c
-CSIDL_COMMON_TEMPLATES          = 0x002d
-CSIDL_COMMON_DOCUMENTS          = 0x002e
-CSIDL_COMMON_ADMINTOOLS         = 0x002f
-CSIDL_ADMINTOOLS                = 0x0030
-CSIDL_CONNECTIONS               = 0x0031
-CSIDL_COMMON_MUSIC              = 0x0035
-CSIDL_COMMON_PICTURES           = 0x0036
-CSIDL_COMMON_VIDEO              = 0x0037
-CSIDL_RESOURCES                 = 0x0038
-CSIDL_RESOURCES_LOCALIZED       = 0x0039
-CSIDL_COMMON_OEM_LINKS          = 0x003a
-CSIDL_CDBURN_AREA               = 0x003b
-CSIDL_COMPUTERSNEARME           = 0x003d
-CSIDL_PROFILES                  = 0x003e
-
-CSIDL_FOLDER_MASK               = 0x00ff
-
-CSIDL_FLAG_PER_USER_INIT        = 0x0800
-CSIDL_FLAG_NO_ALIAS             = 0x1000
-CSIDL_FLAG_DONT_VERIFY          = 0x4000
-CSIDL_FLAG_CREATE               = 0x8000
-
-CSIDL_FLAG_MASK                 = 0xff00
-
-#--- Structures ---------------------------------------------------------------
+CSIDL_DESKTOP = 0x0000
+CSIDL_INTERNET = 0x0001
+CSIDL_PROGRAMS = 0x0002
+CSIDL_CONTROLS = 0x0003
+CSIDL_PRINTERS = 0x0004
+CSIDL_PERSONAL = 0x0005
+CSIDL_FAVORITES = 0x0006
+CSIDL_STARTUP = 0x0007
+CSIDL_RECENT = 0x0008
+CSIDL_SENDTO = 0x0009
+CSIDL_BITBUCKET = 0x000A
+CSIDL_STARTMENU = 0x000B
+CSIDL_MYDOCUMENTS = CSIDL_PERSONAL
+CSIDL_MYMUSIC = 0x000D
+CSIDL_MYVIDEO = 0x000E
+CSIDL_DESKTOPDIRECTORY = 0x0010
+CSIDL_DRIVES = 0x0011
+CSIDL_NETWORK = 0x0012
+CSIDL_NETHOOD = 0x0013
+CSIDL_FONTS = 0x0014
+CSIDL_TEMPLATES = 0x0015
+CSIDL_COMMON_STARTMENU = 0x0016
+CSIDL_COMMON_PROGRAMS = 0x0017
+CSIDL_COMMON_STARTUP = 0x0018
+CSIDL_COMMON_DESKTOPDIRECTORY = 0x0019
+CSIDL_APPDATA = 0x001A
+CSIDL_PRINTHOOD = 0x001B
+CSIDL_LOCAL_APPDATA = 0x001C
+CSIDL_ALTSTARTUP = 0x001D
+CSIDL_COMMON_ALTSTARTUP = 0x001E
+CSIDL_COMMON_FAVORITES = 0x001F
+CSIDL_INTERNET_CACHE = 0x0020
+CSIDL_COOKIES = 0x0021
+CSIDL_HISTORY = 0x0022
+CSIDL_COMMON_APPDATA = 0x0023
+CSIDL_WINDOWS = 0x0024
+CSIDL_SYSTEM = 0x0025
+CSIDL_PROGRAM_FILES = 0x0026
+CSIDL_MYPICTURES = 0x0027
+CSIDL_PROFILE = 0x0028
+CSIDL_SYSTEMX86 = 0x0029
+CSIDL_PROGRAM_FILESX86 = 0x002A
+CSIDL_PROGRAM_FILES_COMMON = 0x002B
+CSIDL_PROGRAM_FILES_COMMONX86 = 0x002C
+CSIDL_COMMON_TEMPLATES = 0x002D
+CSIDL_COMMON_DOCUMENTS = 0x002E
+CSIDL_COMMON_ADMINTOOLS = 0x002F
+CSIDL_ADMINTOOLS = 0x0030
+CSIDL_CONNECTIONS = 0x0031
+CSIDL_COMMON_MUSIC = 0x0035
+CSIDL_COMMON_PICTURES = 0x0036
+CSIDL_COMMON_VIDEO = 0x0037
+CSIDL_RESOURCES = 0x0038
+CSIDL_RESOURCES_LOCALIZED = 0x0039
+CSIDL_COMMON_OEM_LINKS = 0x003A
+CSIDL_CDBURN_AREA = 0x003B
+CSIDL_COMPUTERSNEARME = 0x003D
+CSIDL_PROFILES = 0x003E
+
+CSIDL_FOLDER_MASK = 0x00FF
+
+CSIDL_FLAG_PER_USER_INIT = 0x0800
+CSIDL_FLAG_NO_ALIAS = 0x1000
+CSIDL_FLAG_DONT_VERIFY = 0x4000
+CSIDL_FLAG_CREATE = 0x8000
+
+CSIDL_FLAG_MASK = 0xFF00
+
+# --- Structures ---------------------------------------------------------------
 
 # typedef struct _SHELLEXECUTEINFO {
 #   DWORD     cbSize;
@@ -175,34 +175,39 @@ CSIDL_FLAG_MASK                 = 0xff00
 #   HANDLE    hProcess;
 # } SHELLEXECUTEINFO, *LPSHELLEXECUTEINFO;
 
+
 class SHELLEXECUTEINFO(Structure):
     _fields_ = [
-        ("cbSize",       DWORD),
-        ("fMask",        ULONG),
-        ("hwnd",         HWND),
-        ("lpVerb",       LPSTR),
-        ("lpFile",       LPSTR),
+        ("cbSize", DWORD),
+        ("fMask", ULONG),
+        ("hwnd", HWND),
+        ("lpVerb", LPSTR),
+        ("lpFile", LPSTR),
         ("lpParameters", LPSTR),
-        ("lpDirectory",  LPSTR),
-        ("nShow",        ctypes.c_int),
-        ("hInstApp",     HINSTANCE),
-        ("lpIDList",     LPVOID),
-        ("lpClass",      LPSTR),
-        ("hkeyClass",    HKEY),
-        ("dwHotKey",     DWORD),
-        ("hIcon",        HANDLE),
-        ("hProcess",     HANDLE),
+        ("lpDirectory", LPSTR),
+        ("nShow", ctypes.c_int),
+        ("hInstApp", HINSTANCE),
+        ("lpIDList", LPVOID),
+        ("lpClass", LPSTR),
+        ("hkeyClass", HKEY),
+        ("dwHotKey", DWORD),
+        ("hIcon", HANDLE),
+        ("hProcess", HANDLE),
     ]
 
     def __get_hMonitor(self):
         return self.hIcon
+
     def __set_hMonitor(self, hMonitor):
         self.hIcon = hMonitor
+
     hMonitor = property(__get_hMonitor, __set_hMonitor)
 
+
 LPSHELLEXECUTEINFO = POINTER(SHELLEXECUTEINFO)
 
-#--- shell32.dll --------------------------------------------------------------
+# --- shell32.dll --------------------------------------------------------------
+
 
 # LPWSTR *CommandLineToArgvW(
 #     LPCWSTR lpCmdLine,
@@ -211,7 +216,7 @@ LPSHELLEXECUTEINFO = POINTER(SHELLEXECUTEINFO)
 def CommandLineToArgvW(lpCmdLine):
     _CommandLineToArgvW = windll.shell32.CommandLineToArgvW
     _CommandLineToArgvW.argtypes = [LPVOID, POINTER(ctypes.c_int)]
-    _CommandLineToArgvW.restype  = LPVOID
+    _CommandLineToArgvW.restype = LPVOID
 
     if not lpCmdLine:
         lpCmdLine = None
@@ -224,13 +229,14 @@ def CommandLineToArgvW(lpCmdLine):
         argc = argc.value
         if argc <= 0:
             raise ctypes.WinError()
-        argv = ctypes.cast(argv, ctypes.POINTER(LPWSTR * argc) )
-        argv = [ argv.contents[i] for i in compat.xrange(0, argc) ]
+        argv = ctypes.cast(argv, ctypes.POINTER(LPWSTR * argc))
+        argv = [argv.contents[i] for i in compat.xrange(0, argc)]
     finally:
         if vptr is not None:
             LocalFree(vptr)
     return argv
 
+
 def CommandLineToArgvA(lpCmdLine):
     t_ansi = GuessStringType.t_ansi
     t_unicode = GuessStringType.t_unicode
@@ -240,8 +246,10 @@ def CommandLineToArgvA(lpCmdLine):
         cmdline = lpCmdLine
     return [t_ansi(x) for x in CommandLineToArgvW(cmdline)]
 
+
 CommandLineToArgv = GuessStringType(CommandLineToArgvA, CommandLineToArgvW)
 
+
 # HINSTANCE ShellExecute(
 #     HWND hwnd,
 #     LPCTSTR lpOperation,
@@ -250,34 +258,37 @@ CommandLineToArgv = GuessStringType(CommandLineToArgvA, CommandLineToArgvW)
 #     LPCTSTR lpDirectory,
 #     INT nShowCmd
 # );
-def ShellExecuteA(hwnd = None, lpOperation = None, lpFile = None, lpParameters = None, lpDirectory = None, nShowCmd = None):
+def ShellExecuteA(hwnd=None, lpOperation=None, lpFile=None, lpParameters=None, lpDirectory=None, nShowCmd=None):
     _ShellExecuteA = windll.shell32.ShellExecuteA
     _ShellExecuteA.argtypes = [HWND, LPSTR, LPSTR, LPSTR, LPSTR, INT]
-    _ShellExecuteA.restype  = HINSTANCE
+    _ShellExecuteA.restype = HINSTANCE
 
     if not nShowCmd:
         nShowCmd = 0
     success = _ShellExecuteA(hwnd, lpOperation, lpFile, lpParameters, lpDirectory, nShowCmd)
     success = ctypes.cast(success, c_int)
     success = success.value
-    if not success > 32:    # weird! isn't it?
+    if not success > 32:  # weird! isn't it?
         raise ctypes.WinError(success)
 
-def ShellExecuteW(hwnd = None, lpOperation = None, lpFile = None, lpParameters = None, lpDirectory = None, nShowCmd = None):
+
+def ShellExecuteW(hwnd=None, lpOperation=None, lpFile=None, lpParameters=None, lpDirectory=None, nShowCmd=None):
     _ShellExecuteW = windll.shell32.ShellExecuteW
     _ShellExecuteW.argtypes = [HWND, LPWSTR, LPWSTR, LPWSTR, LPWSTR, INT]
-    _ShellExecuteW.restype  = HINSTANCE
+    _ShellExecuteW.restype = HINSTANCE
 
     if not nShowCmd:
         nShowCmd = 0
     success = _ShellExecuteW(hwnd, lpOperation, lpFile, lpParameters, lpDirectory, nShowCmd)
     success = ctypes.cast(success, c_int)
     success = success.value
-    if not success > 32:    # weird! isn't it?
+    if not success > 32:  # weird! isn't it?
         raise ctypes.WinError(success)
 
+
 ShellExecute = GuessStringType(ShellExecuteA, ShellExecuteW)
 
+
 # BOOL ShellExecuteEx(
 #   __inout  LPSHELLEXECUTEINFO lpExecInfo
 # );
@@ -289,53 +300,59 @@ def ShellExecuteEx(lpExecInfo):
     else:
         raise TypeError("Expected SHELLEXECUTEINFOA or SHELLEXECUTEINFOW, got %s instead" % type(lpExecInfo))
 
+
 def ShellExecuteExA(lpExecInfo):
     _ShellExecuteExA = windll.shell32.ShellExecuteExA
     _ShellExecuteExA.argtypes = [LPSHELLEXECUTEINFOA]
-    _ShellExecuteExA.restype  = BOOL
+    _ShellExecuteExA.restype = BOOL
     _ShellExecuteExA.errcheck = RaiseIfZero
     _ShellExecuteExA(byref(lpExecInfo))
 
+
 def ShellExecuteExW(lpExecInfo):
     _ShellExecuteExW = windll.shell32.ShellExecuteExW
     _ShellExecuteExW.argtypes = [LPSHELLEXECUTEINFOW]
-    _ShellExecuteExW.restype  = BOOL
+    _ShellExecuteExW.restype = BOOL
     _ShellExecuteExW.errcheck = RaiseIfZero
     _ShellExecuteExW(byref(lpExecInfo))
 
+
 # HINSTANCE FindExecutable(
 #   __in      LPCTSTR lpFile,
 #   __in_opt  LPCTSTR lpDirectory,
 #   __out     LPTSTR lpResult
 # );
-def FindExecutableA(lpFile, lpDirectory = None):
+def FindExecutableA(lpFile, lpDirectory=None):
     _FindExecutableA = windll.shell32.FindExecutableA
     _FindExecutableA.argtypes = [LPSTR, LPSTR, LPSTR]
-    _FindExecutableA.restype  = HINSTANCE
+    _FindExecutableA.restype = HINSTANCE
 
     lpResult = ctypes.create_string_buffer(MAX_PATH)
     success = _FindExecutableA(lpFile, lpDirectory, lpResult)
     success = ctypes.cast(success, ctypes.c_void_p)
     success = success.value
-    if not success > 32:    # weird! isn't it?
+    if not success > 32:  # weird! isn't it?
         raise ctypes.WinError(success)
     return lpResult.value
 
-def FindExecutableW(lpFile, lpDirectory = None):
+
+def FindExecutableW(lpFile, lpDirectory=None):
     _FindExecutableW = windll.shell32.FindExecutableW
     _FindExecutableW.argtypes = [LPWSTR, LPWSTR, LPWSTR]
-    _FindExecutableW.restype  = HINSTANCE
+    _FindExecutableW.restype = HINSTANCE
 
     lpResult = ctypes.create_unicode_buffer(MAX_PATH)
     success = _FindExecutableW(lpFile, lpDirectory, lpResult)
     success = ctypes.cast(success, ctypes.c_void_p)
     success = success.value
-    if not success > 32:    # weird! isn't it?
+    if not success > 32:  # weird! isn't it?
         raise ctypes.WinError(success)
     return lpResult.value
 
+
 FindExecutable = GuessStringType(FindExecutableA, FindExecutableW)
 
+
 # HRESULT SHGetFolderPath(
 #   __in   HWND hwndOwner,
 #   __in   int nFolder,
@@ -343,40 +360,44 @@ FindExecutable = GuessStringType(FindExecutableA, FindExecutableW)
 #   __in   DWORD dwFlags,
 #   __out  LPTSTR pszPath
 # );
-def SHGetFolderPathA(nFolder, hToken = None, dwFlags = SHGFP_TYPE_CURRENT):
-    _SHGetFolderPathA = windll.shell32.SHGetFolderPathA     # shfolder.dll in older win versions
+def SHGetFolderPathA(nFolder, hToken=None, dwFlags=SHGFP_TYPE_CURRENT):
+    _SHGetFolderPathA = windll.shell32.SHGetFolderPathA  # shfolder.dll in older win versions
     _SHGetFolderPathA.argtypes = [HWND, ctypes.c_int, HANDLE, DWORD, LPSTR]
-    _SHGetFolderPathA.restype  = HRESULT
-    _SHGetFolderPathA.errcheck = RaiseIfNotZero # S_OK == 0
+    _SHGetFolderPathA.restype = HRESULT
+    _SHGetFolderPathA.errcheck = RaiseIfNotZero  # S_OK == 0
 
     pszPath = ctypes.create_string_buffer(MAX_PATH + 1)
     _SHGetFolderPathA(None, nFolder, hToken, dwFlags, pszPath)
     return pszPath.value
 
-def SHGetFolderPathW(nFolder, hToken = None, dwFlags = SHGFP_TYPE_CURRENT):
-    _SHGetFolderPathW = windll.shell32.SHGetFolderPathW     # shfolder.dll in older win versions
+
+def SHGetFolderPathW(nFolder, hToken=None, dwFlags=SHGFP_TYPE_CURRENT):
+    _SHGetFolderPathW = windll.shell32.SHGetFolderPathW  # shfolder.dll in older win versions
     _SHGetFolderPathW.argtypes = [HWND, ctypes.c_int, HANDLE, DWORD, LPWSTR]
-    _SHGetFolderPathW.restype  = HRESULT
-    _SHGetFolderPathW.errcheck = RaiseIfNotZero # S_OK == 0
+    _SHGetFolderPathW.restype = HRESULT
+    _SHGetFolderPathW.errcheck = RaiseIfNotZero  # S_OK == 0
 
     pszPath = ctypes.create_unicode_buffer(MAX_PATH + 1)
     _SHGetFolderPathW(None, nFolder, hToken, dwFlags, pszPath)
     return pszPath.value
 
+
 SHGetFolderPath = DefaultStringType(SHGetFolderPathA, SHGetFolderPathW)
 
+
 # BOOL IsUserAnAdmin(void);
 def IsUserAnAdmin():
     # Supposedly, IsUserAnAdmin() is deprecated in Vista.
     # But I tried it on Windows 7 and it works just fine.
     _IsUserAnAdmin = windll.shell32.IsUserAnAdmin
     _IsUserAnAdmin.argtypes = []
-    _IsUserAnAdmin.restype  = bool
+    _IsUserAnAdmin.restype = bool
     return _IsUserAnAdmin()
 
-#==============================================================================
+
+# ==============================================================================
 # This calculates the list of exported symbols.
 _all = set(vars().keys()).difference(_all)
-__all__ = [_x for _x in _all if not _x.startswith('_')]
+__all__ = [_x for _x in _all if not _x.startswith("_")]
 __all__.sort()
-#==============================================================================
+# ==============================================================================