[pywin32] Add parameters for incomplete functions (#15512)

2026-05-07 22:10:10 +08:00 · 2026-03-17 01:29:14 +04:00
parent ed11953534
commit 143d22ce2b
22 changed files with 104 additions and 102 deletions
@@ -609,8 +609,8 @@ class PyConsoleScreenBuffer:
    def ReadConsoleInput(self, Length) -> tuple[PyINPUT_RECORD, ...]: ...
    def PeekConsoleInput(self, Length) -> tuple[PyINPUT_RECORD, ...]: ...
    def GetNumberOfConsoleInputEvents(self): ...
-    def Close(self, *args): ...  # incomplete
-    def Detach(self, *args): ...  # incomplete
+    def Close(self) -> None: ...
+    def Detach(self) -> int: ...

@disjoint_base
 class PyCredHandle:
@@ -929,7 +929,7 @@ class PyHDESK:
    def EnumDesktopWindows(self) -> tuple[int, ...]: ...
    def SwitchDesktop(self) -> None: ...
    def CloseDesktop(self) -> None: ...
-    def Detach(self, *args): ...  # incomplete
+    def Detach(self) -> int: ...

 class PyHDEVNOTIFY: ...

@@ -1066,7 +1066,7 @@ class PyHWINSTA:
    def EnumDesktops(self) -> tuple[Incomplete, ...]: ...
    def SetProcessWindowStation(self) -> None: ...
    def CloseWindowStation(self) -> None: ...
-    def Detach(self, *args): ...  # incomplete
+    def Detach(self) -> int: ...

 class PyICONINFO: ...

@@ -54,13 +54,13 @@ def CoRevokeClassObject(reg: int, /) -> None: ...
 def CoTreatAsClass(clsidold: _win32typing.PyIID, clsidnew: _win32typing.PyIID, /) -> None: ...
 def CoWaitForMultipleHandles(Flags, Timeout, Handles: list[int], /): ...
 def Connect(cls, /) -> _win32typing.PyIDispatch: ...
-def connect(*args): ...  # incomplete
+def connect(cls, /) -> _win32typing.PyIDispatch: ...
 def CreateGuid() -> _win32typing.PyIID: ...
 def CreateBindCtx() -> _win32typing.PyIBindCtx: ...
 def CreateFileMoniker(filename: str, /) -> _win32typing.PyIMoniker: ...
 def CreateItemMoniker(delim: str, item: str, /) -> _win32typing.PyIMoniker: ...
 def CreatePointerMoniker(IUnknown: _win32typing.PyIUnknown, /) -> _win32typing.PyIMoniker: ...
-def CreateURLMonikerEx(*args): ...  # incomplete
+def CreateURLMonikerEx(Context, URL, Flags: int = ..., /): ...
 def CreateTypeLib(): ...
 def CreateTypeLib2(): ...
 def CreateStreamOnHGlobal(hGlobal: int | None = ..., DeleteOnRelease: bool = ..., /) -> _win32typing.PyIStream: ...
@@ -16,11 +16,11 @@ CBF_SKIP_CONNECT_CONFIRMS: int
 CBF_SKIP_DISCONNECTS: int
 CBF_SKIP_REGISTRATIONS: int

-def CreateConversation(*args): ...  # incomplete
-def CreateServer(*args): ...  # incomplete
-def CreateServerSystemTopic(*args): ...  # incomplete
-def CreateStringItem(*args): ...  # incomplete
-def CreateTopic(*args): ...  # incomplete
+def CreateConversation(Server, /): ...
+def CreateServer(): ...
+def CreateServerSystemTopic(): ...
+def CreateStringItem(name, /): ...
+def CreateTopic(name, /): ...

 MF_CALLBACKS: int
 MF_CONV: int
@@ -145,13 +145,13 @@ def TranslateMessage(): ...
 def TranslateVirtualKey(vk, /) -> str: ...
 def WinHelp(arg, data: str, /) -> None: ...
 def WriteProfileVal(section: str, entry: str, value: str, /) -> None: ...
-def AddToRecentFileList(*args): ...  # incomplete
-def CreateImageList(*args): ...  # incomplete
-def CreateListCtrl(*args): ...  # incomplete
-def CreateListView(*args): ...  # incomplete
-def CreateRectRgn(*args): ...  # incomplete
-def GetRecentFileList(*args): ...  # incomplete
-def OutputDebug(*args): ...  # incomplete
+def AddToRecentFileList(fname, /): ...
+def CreateImageList(cx, cy, mask, initial, grow, /): ...
+def CreateListCtrl(): ...
+def CreateListView(doc, /): ...
+def CreateRectRgn(rect: tuple[Incomplete, Incomplete, Incomplete, Incomplete], /): ...
+def GetRecentFileList() -> list[Incomplete]: ...
+def OutputDebug(msg: str, /) -> None: ...

 AFX_IDW_PANE_FIRST: int
 AFX_IDW_PANE_LAST: int
@@ -12,7 +12,7 @@ def OleGetUserCtrl(): ...
 def OleSetUserCtrl(bUserCtrl, /): ...
 def SetMessagePendingDelay(delay, /) -> None: ...
 def EnableNotRespondingDialog(enabled, /) -> None: ...
-def EnableBusyDialog(*args): ...  # incomplete
+def EnableBusyDialog(enabled, /) -> None: ...

 COleClientItem_activeState: int
 COleClientItem_activeUIState: int
@@ -2,7 +2,7 @@ RASEAPF_Logon: int
 RASEAPF_NonInteractive: int
 RASEAPF_Preview: int

-def GetEapUserIdentity(*args): ...  # incomplete
+def GetEapUserIdentity(phoneBook: str | None, entry: str, flags: int, hwnd=None, /): ...

 RASCS_AllDevicesConnected: int
 RASCS_AuthAck: int
@@ -314,13 +314,13 @@ def RGB(red: int, green: int, blue: int, /) -> int: ...
 def MAKELANGID(PrimaryLanguage, SubLanguage, /): ...
 def MAKEWORD(low, high, /): ...
 def MAKELONG(low, high, /): ...
-def CommandLineToArgv(*args): ...  # incomplete
+def CommandLineToArgv(cmdLine: str, /) -> list[str]: ...
 def GetKeyboardLayoutList() -> tuple[int, int]: ...
-def MapVirtualKey(*args): ...  # incomplete
-def MessageBoxEx(*args): ...  # incomplete
-def OpenThread(*args): ...  # incomplete
-def SleepEx(*args): ...  # incomplete
-def VkKeyScanEx(*args): ...  # incomplete
+def MapVirtualKey(vk: int, type: int, hlayout=None, /) -> int: ...
+def MessageBoxEx(hwnd, message: str, title: str | None = ..., style: int = ..., language: int = ..., /) -> int: ...
+def OpenThread(reqdAccess: int, bInherit, pid: int, /): ...
+def SleepEx(time: int, bAlterable=0, /) -> int: ...
+def VkKeyScanEx(char: str | bytes, hkl, /) -> int: ...

 NameCanonical: int
 NameCanonicalEx: int
@@ -36,7 +36,7 @@ def WaitForMultipleObjectsEx(handlelist: list[int], bWaitAll, milliseconds, bAle
 def WaitForSingleObject(hHandle: int, milliseconds: int, /) -> int: ...
 def WaitForSingleObjectEx(hHandle: int, milliseconds, bAlertable, /): ...
 def WaitForInputIdle(hProcess: int, milliseconds, /): ...
-def SignalObjectAndWait(*args): ...  # incomplete
+def SignalObjectAndWait(hSignal, hWaitOn, milliseconds, bAlertable, /): ...

 CREATE_WAITABLE_TIMER_HIGH_RESOLUTION: int
 CREATE_WAITABLE_TIMER_MANUAL_RESET: int
@@ -267,8 +267,8 @@ def OpenFileById(
    Flags,
    SecurityAttributes: _win32typing.PySECURITY_ATTRIBUTES | None = ...,
 ) -> int: ...
-def DCB(*args): ...  # incomplete
-def GetFileAttributesExW(*args): ...  # incomplete
+def DCB() -> _win32typing.PyDCB: ...
+def GetFileAttributesExW(FileName: str, InfoLevelId: int = ..., Transaction: int | None = None): ...
 def OVERLAPPED() -> _win32typing.PyOVERLAPPED: ...

 CALLBACK_CHUNK_FINISHED: int
@@ -475,33 +475,33 @@ def RegisterHotKey(hWnd: _win32typing.PyHANDLE | int | None, _id: int, Modifiers
 def UnregisterHotKey(hWnd: _win32typing.PyHANDLE | int | None, _id: int, /) -> None: ...
 def GetAncestor(hwnd: int, gaFlags: int, /) -> int: ...
 def GetTopWindow(hWnd: int | None, /) -> int: ...
-def ChildWindowFromPointEx(*args): ...  # incomplete
-def CreateDialogIndirectParam(*args): ...  # incomplete
-def DestroyAcceleratorTable(*args): ...  # incomplete
-def Edit_GetLine(*args): ...  # incomplete
+def ChildWindowFromPointEx(hwndParent: int, point: tuple[Incomplete, Incomplete], flags: int, /): ...
+def CreateDialogIndirectParam(hInstance, controlList, hWndParent, DialogFunc, InitParam: int = 0, /) -> int: ...
+def DestroyAcceleratorTable(haccel, /): ...
+def Edit_GetLine(hwnd, line, size=..., /): ...
 def GetModuleHandle(lpModuleName: str | None, /) -> int: ...
-def GetWindowTextLength(*args): ...  # incomplete
-def HIWORD(*args): ...  # incomplete
-def ImageList_Add(*args): ...  # incomplete
-def ImageList_Create(*args): ...  # incomplete
-def ImageList_Destroy(*args): ...  # incomplete
-def ImageList_Draw(*args): ...  # incomplete
-def ImageList_DrawEx(*args): ...  # incomplete
-def ImageList_GetIcon(*args): ...  # incomplete
-def ImageList_GetImageCount(*args): ...  # incomplete
-def ImageList_LoadBitmap(*args): ...  # incomplete
-def ImageList_LoadImage(*args): ...  # incomplete
-def ImageList_Remove(*args): ...  # incomplete
-def ImageList_Replace(*args): ...  # incomplete
-def ImageList_ReplaceIcon(*args): ...  # incomplete
-def ImageList_SetBkColor(*args): ...  # incomplete
-def ImageList_SetOverlayImage(*args): ...  # incomplete
-def LOWORD(*args): ...  # incomplete
-def ListView_SortItems(*args): ...  # incomplete
-def ListView_SortItemsEx(*args): ...  # incomplete
-def ValidateRect(*args): ...  # incomplete
+def GetWindowTextLength(hwnd, /) -> int: ...
+def HIWORD(val: int, /) -> int: ...
+def ImageList_Add(hImageList, hbmImage, hbmMask, /) -> int: ...
+def ImageList_Create(cx: int, cy: int, flags: int, cInitial: int, cGrow: int, /): ...
+def ImageList_Destroy(hImageList, /): ...
+def ImageList_Draw(hImageList, i: int, hdcDst, x: int, y: int, fStyle, /): ...
+def ImageList_DrawEx(hImageList, i: int, hdcDst, x: int, y: int, dx: int, dy: int, rgbBk, rgbFg, fStyle, /): ...
+def ImageList_GetIcon(hImageList, i: int, flag: int, /): ...
+def ImageList_GetImageCount(hImageList, /) -> int: ...
+def ImageList_LoadBitmap(hInst, name, cx: int, cGrow: int, crMask, /): ...
+def ImageList_LoadImage(hInst, name, cx: int, cGrow: int, crMask, uType, uFlags, /): ...
+def ImageList_Remove(hImageList, i, /): ...
+def ImageList_Replace(hImageList, i, hicon, /): ...
+def ImageList_ReplaceIcon(hImageList, i, hicon, /): ...
+def ImageList_SetBkColor(hImageList, Color, /): ...
+def ImageList_SetOverlayImage(hImageList, iImage, iOverlay, /): ...
+def LOWORD(val: int, /) -> int: ...
+def ListView_SortItems(hwnd, callback, param=None, /) -> None: ...
+def ListView_SortItemsEx(hwnd, callback, param=None, /) -> None: ...
+def ValidateRect(hWnd, Rect, /): ...
 def WNDCLASS() -> _win32typing.PyWNDCLASS: ...
-def lpstr(*args): ...  # incomplete
+def lpstr(address, /) -> bytes: ...

 CLR_NONE: int
 ILC_COLOR: int
@@ -61,9 +61,9 @@ def SetUrlCacheEntryGroup(UrlName, Flags, GroupId) -> None: ...
 def GetUrlCacheGroupAttribute(GroupId, Attributes=...): ...
 def SetUrlCacheGroupAttribute(GroupId, Attributes, GroupInfo, Flags=...) -> None: ...
 def DeleteUrlCacheEntry(UrlName, /) -> None: ...
-def WinHttpGetDefaultProxyConfiguration(*args): ...  # incomplete
-def WinHttpGetIEProxyConfigForCurrentUser(*args): ...  # incomplete
-def WinHttpGetProxyForUrl(*args): ...  # incomplete
-def WinHttpOpen(*args): ...  # incomplete
+def WinHttpGetDefaultProxyConfiguration(): ...
+def WinHttpGetIEProxyConfigForCurrentUser() -> tuple[int, str, str, str]: ...
+def WinHttpGetProxyForUrl(handle: _win32typing.PyHANDLE | int | None, url: str, options: tuple[int | str | None, ...], /): ...
+def WinHttpOpen(lpszUserAgent: str, dwAccessType: int, lpszProxyName: str, lpszProxyBypass: str, dwFlags: int, /): ...

 UNICODE: int
@@ -81,11 +81,11 @@ def NetServerComputerNameAdd(ServerName: str, EmulatedDomainName: str, EmulatedS
 def NetServerComputerNameDel(ServerName: str, EmulatedServerName: str, /) -> None: ...
 def NetValidateName(Server: str, Name: str, NameType, Account: str | None = ..., Password: str | None = ..., /) -> None: ...
 def NetValidatePasswordPolicy(Server: str, Qualifier, ValidationType, arg, /) -> None: ...
-def NetLocalGroupAdd(*args): ...  # incomplete
-def NetLocalGroupDel(*args): ...  # incomplete
-def NetLocalGroupEnum(*args): ...  # incomplete
-def NetLocalGroupGetInfo(*args): ...  # incomplete
-def NetLocalGroupSetInfo(*args): ...  # incomplete
+def NetLocalGroupAdd(server: str, level: int, data, /) -> None: ...
+def NetLocalGroupDel(server: str, groupname: str, data, /) -> None: ...
+def NetLocalGroupEnum(server: str, level: int, resumeHandle=..., prefLen: int = ..., /): ...
+def NetLocalGroupGetInfo(server: str, groupname: str, level: int, /): ...
+def NetLocalGroupSetInfo(server: str, groupname: str, level: int, data, /) -> None: ...

 SERVICE_SERVER: str
 SERVICE_WORKSTATION: str
@@ -1,5 +1,6 @@
 from _typeshed import Incomplete

+import _win32typing
 from win32.lib.pywintypes import error as error

 def AddCounter(hQuery, path: str, userData: int = ..., /): ...
@@ -36,7 +37,7 @@ def BrowseCounters(
 def ConnectMachine(machineName: str, /) -> str: ...
 def LookupPerfIndexByName(machineName: str, instanceName: str, /): ...
 def LookupPerfNameByIndex(machineName: str | None, index, /) -> str: ...
-def GetFormattedCounterArray(*args): ...  # incomplete
+def GetFormattedCounterArray(handle: _win32typing.PyHANDLE | int | None, format: int, /) -> dict[Incomplete, Incomplete]: ...

 PDH_FMT_1000: int
 PDH_FMT_ANSI: int
@@ -74,10 +74,10 @@ def GetProcessShutdownParameters() -> tuple[Incomplete, Incomplete]: ...
 def SetProcessShutdownParameters(Level, Flags, /) -> None: ...
 def GetGuiResources(Process: int, Flags, /): ...
 def IsWow64Process(Process: int | None = ..., /) -> bool: ...
-def ReadProcessMemory(*args): ...  # incomplete
-def VirtualAllocEx(*args): ...  # incomplete
-def VirtualFreeEx(*args): ...  # incomplete
-def WriteProcessMemory(*args): ...  # incomplete
+def ReadProcessMemory(hProcess, address: int, size: int, /) -> bytes: ...
+def VirtualAllocEx(hProcess, address: int, size: int, allocationType: int, flProtect: int, /): ...
+def VirtualFreeEx(hProcess, address: int, size: int, freeType: int, /): ...
+def WriteProcessMemory(hProcess, address, buf, /) -> int: ...

 ABOVE_NORMAL_PRIORITY_CLASS: int
 BELOW_NORMAL_PRIORITY_CLASS: int
@@ -18,7 +18,7 @@ def GetErrorString(error, /) -> str: ...  # noqa: F811
 def HangUp(hras, /) -> None: ...
 def IsHandleValid(hras: int | None, /) -> bool: ...
 def SetEntryDialParams(fileName: str, RasDialParams, bSavePassword, /) -> None: ...
-def RASDIALEXTENSIONS(*args): ...  # incomplete
+def RASDIALEXTENSIONS() -> _win32typing.RASDIALEXTENSIONS: ...

 RASCS_AllDevicesConnected: int
 RASCS_AuthAck: int
@@ -49,7 +49,7 @@ RASCS_StartAuthentication: int
 RASCS_WaitForCallback: int
 RASCS_WaitForModemReset: int

-def GetEapUserIdentity(*args): ...  # incomplete
+def GetEapUserIdentity(phoneBook: str | None, entry: str, flags: int, hwnd: _win32typing.PyHANDLE | int | None = None, /): ...

 RASEAPF_Logon: int
 RASEAPF_NonInteractive: int
@@ -416,13 +416,14 @@ UNPROTECTED_SACL_SECURITY_INFORMATION: int
 CredHandleType = _win32typing.PyCredHandle
 CtxtHandleType = _win32typing.PyCtxtHandle

-def DsListDomainsInSite(*args): ...  # incomplete
-def DsListInfoForServer(*args): ...  # incomplete
-def DsListRoles(*args): ...  # incomplete
-def DsListServersForDomainInSite(*args): ...  # incomplete
-def DsListServersInSite(*args): ...  # incomplete
-def DsListSites(*args): ...  # incomplete
-def GetPolicyHandle(*args): ...  # incomplete
+def DsListDomainsInSite(hds, site: str, /): ...
+def DsListInfoForServer(hds, server: str, /): ...
+def DsListRoles(hds, /): ...
+def DsListServersForDomainInSite(hds, domain: str, site: str, /): ...
+def DsListServersInSite(hds, site: str, /): ...
+def DsListSites(hds, /): ...
+
+GetPolicyHandle = LsaOpenPolicy

 MICROSOFT_KERBEROS_NAME_A: bytes
 MSV1_0_PACKAGE_NAME: bytes
@@ -1,13 +1,13 @@
 from win32.lib.pywintypes import error as error

-def GetHandle(*args): ...  # incomplete
+def GetHandle() -> int: ...
 def GetTracer(): ...
-def InitRead(*args): ...  # incomplete
-def InitWrite(*args): ...  # incomplete
-def TermRead(*args): ...  # incomplete
-def TermWrite(*args): ...  # incomplete
-def blockingread(*args): ...  # incomplete
-def flush(*args): ...  # incomplete
-def read(*args): ...  # incomplete
-def setprint(*args): ...  # incomplete
-def write(*args): ...  # incomplete
+def InitRead() -> None: ...
+def InitWrite() -> None: ...
+def TermRead() -> None: ...
+def TermWrite() -> None: ...
+def blockingread(milliSeconds: int = ..., /) -> str: ...
+def flush() -> None: ...
+def read() -> str: ...
+def setprint() -> None: ...
+def write(data: str, /) -> None: ...
@@ -11,7 +11,7 @@ def ADsGetObject(path, iid: _win32typing.PyIID, /): ...
 def ADsBuildEnumerator(container: _win32typing.PyIADsContainer, /): ...
 def ADsEnumerateNext(enum, num: int = ..., /): ...
 def ADsGetLastError() -> tuple[Incomplete, Incomplete, Incomplete]: ...
-def StringAsDS_SELECTION_LIST(*args): ...  # incomplete
+def StringAsDS_SELECTION_LIST(buf, /): ...

 DSOP_SCOPE_INIT_INFOs = _win32typing.PyDSOP_SCOPE_INIT_INFOs
 CLSID_ADsDSOObject: _win32typing.PyIID
@@ -2,9 +2,9 @@
 # "ImportError: DLL load failed while importing axdebug: The specified module could not be found."
 import _win32typing

-def GetStackAddress(*args): ...  # incomplete
-def GetThreadStateHandle(*args): ...  # incomplete
-def SetThreadStateTrace(*args): ...  # incomplete
+def GetStackAddress() -> int: ...
+def GetThreadStateHandle() -> int: ...
+def SetThreadStateTrace(handle: int, func, /) -> None: ...

 APPBREAKFLAG_DEBUGGER_BLOCK: int
 APPBREAKFLAG_DEBUGGER_HALT: int
@@ -1,8 +1,8 @@
 import _win32typing

-def BindIFilterFromStorage(*args): ...  # incomplete
-def BindIFilterFromStream(*args): ...  # incomplete
-def LoadIFilter(*args): ...  # incomplete
+def BindIFilterFromStorage(stg, /): ...
+def BindIFilterFromStream(stg, /): ...
+def LoadIFilter(path: str, /): ...

 CHUNK_EOC: int
 CHUNK_EOP: int
@@ -38,7 +38,7 @@ def HrSetOneProp(prop: _win32typing.PyIMAPIProp, propValue: _win32typing.PySProp
 def HrAllocAdviseSink(callback, context, /): ...
 def HrThisThreadAdviseSink(_object, /): ...
 def HrDispatchNotifications(*args): ...  # incomplete
-def MAPIUIDFromBinary(*args): ...  # incomplete
+def MAPIUIDFromBinary(sz: str | None, /): ...

 AB_NO_DIALOG: int
 ATTACH_BY_REF_ONLY: int
@@ -103,12 +103,12 @@ def SHCreateStreamOnFileEx(
 def SetCurrentProcessExplicitAppUserModelID(AppID: str, /) -> None: ...
 def GetCurrentProcessExplicitAppUserModelID() -> str: ...
 def SHParseDisplayName(Name, Attributes, BindCtx: _win32typing.PyIBindCtx | None = ...) -> tuple[list[bytes], int]: ...
-def SHCreateItemFromIDList(*args): ...  # incomplete
-def SHCreateShellItemArrayFromIDLists(*args): ...  # incomplete
-def SHGetIDListFromObject(*args): ...  # incomplete
-def SHGetNameFromIDList(*args): ...  # incomplete
-def SHGetPathFromIDList(*args): ...  # incomplete
-def SHGetPathFromIDListW(*args): ...  # incomplete
+def SHCreateItemFromIDList(pidl, riid=..., /): ...
+def SHCreateShellItemArrayFromIDLists(pidls, /): ...
+def SHGetIDListFromObject(unk, /): ...
+def SHGetNameFromIDList(pidl, flags: int, /): ...
+def SHGetPathFromIDList(pidl, /): ...
+def SHGetPathFromIDListW(Pidl, /): ...

 BHID_AssociationArray: _win32typing.PyIID
 BHID_DataObject: _win32typing.PyIID
@@ -435,4 +435,4 @@ VID_ThumbStrip: _win32typing.PyIID
 VID_Thumbnails: _win32typing.PyIID
 VID_Tile: _win32typing.PyIID

-def SHGetKnownFolderPath(*args): ...  # incomplete
+def SHGetKnownFolderPath(fid, flags: int = 0, token=None, /): ...