comtypes 1.4.16__tar.gz → 1.5.0__tar.gz

{comtypes-1.4.16 → comtypes-1.5.0}/CHANGES.txt

@@ -1,6 +1,43 @@
 Comtypes CHANGELOG
 ==================
 
+Release 1.5.0
+--------------
+* Bump GitHub Actions dependencies. By @junkmd.
+* Refactor enum member iteration in code generator namespaces. By @junkmd.
+* Expose inline typing metadata to type checkers. By @Robolightning.
+* Modernize ``test_pip_install.py`` and include in ``autofmt`` workflow. By @junkmd.
+* Introduce CI type-checking harness. By @junkmd.
+* Add documentations for developers on how this package supports static typing. By @junkmd.
+* Restore numeric ``SAFEARRAY`` to ``numpy.ndarray`` conversion. By @haoxuanjng-lang.
+* Add Python 3.15 to CI matrix. By @junkmd.
+* Support Python 3.15 ``PyCArgObject`` struct layout changes. By @junkmd.
+* Update the code generator to handle Python 3.15's changes to ``enum.IntFlag``. By @junkmd.
+* Add tests for explicit string ``SAFEARRAY`` types inside ``VARIANT``s. By @junkmd.
+* Remove ``setup_logging`` from ``comtypes.logutil``. By @junkmd.
+* Support ``VT_ERROR`` variant type. By @junkmd.
+* Remove ``..._Impl`` comments generation and add member‑level docstrings under ``if TYPE_CHECKING``. By @junkmd.
+* Add tests to show the problems with the current ``VT_I1`` mapping in ``tlbparser``. By @haoxuanjng-lang.
+* Clarify ``ctypes`` ``_b_needsfree_`` ownership in ``tagVARIANT`` and add tests. By @junkmd.
+* Use ``sysmon`` for coverage on Python 3.12. By @junkmd.
+* Resolve remaining type-checking errors. By @junkmd.
+* Improve ``IEnumVARIANT`` type hints. By @junkmd.
+* Refactor ``tlbparser`` and ``codegenerator``. By @junkmd.
+* Improve fixed-point number marshaling and ``VARIANT`` support. By @junkmd.
+* Add record ``SAFEARRAY`` support. By @mementum and @junkmd.
+* Update docs for Python 3.15 support. By @junkmd.
+
+Release 1.4.17
+--------------
+* Unify Windows message handling APIs in ``messageloop.py``. By @junkmd.
+* Replace Internet Explorer with MSXML in ``test_eventinterface.py``. By @junkmd.
+* Improve error handling for ``GetEvents`` with currently unsupported COM servers. By @junkmd.
+* Refactor ``test_basic.py`` to use public APIs. By @junkmd.
+* Skip tests using ``util`` on Python 3.15 alpha/beta. By @junkmd.
+* Refine type hints for COM object creation and retrieval. By @junkmd.
+* Modernize ``IGlobalInterfaceTable`` with type hints. By @junkmd.
+* Fix ``UnboundLocalError`` when all struct packings fail in ``calc_packing``. By @ryanda9910.
+
 Release 1.4.16
 --------------
 * Decompose ``IStorage`` tests and enhance coverage. By @junkmd.

{comtypes-1.4.16/comtypes.egg-info → comtypes-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: comtypes
-Version: 1.4.16
+Version: 1.5.0
 Summary: Pure Python COM package
 Author-email: Thomas Heller <theller@python.net>
 License-Expression: MIT
@@ -33,11 +33,7 @@ Dynamic: license-file
 
 `comtypes` requires Windows and Python 3.9 or later.
 
-- **Note about Python 3.15 and `enum` behavior**  
-  Starting with Python 3.15, the internal handling of `IntFlag`(`Flag`) values is planned to change:  
-  **Negative `IntFlag` members will be reinterpreted by masking them to the defined positive bit domain, instead of keeping their original negative literal values**.  
-  This can affect enumeration types generated by `comtypes` from COM type libraries. Action is needed to maintain literal evaluation.  
-  For details and ongoing discussion, see: [GH-894](https://github.com/enthought/comtypes/issues/894).
+- Version <= [1.4.17](https://pypi.org/project/comtypes/1.4.17/) has issues with enum behavior on Python 3.15 as reported in [GH-894](https://github.com/enthought/comtypes/issues/894). Version [1.5.0](https://pypi.org/project/comtypes/1.5.0/) supports Python 3.15.
 - Version [1.4.12](https://pypi.org/project/comtypes/1.4.12/) is the last version to support Python 3.8.
 - Version <= [1.4.7](https://pypi.org/project/comtypes/1.4.7/) does not work with Python 3.13 as reported in [GH-618](https://github.com/enthought/comtypes/issues/618). Version [1.4.8](https://pypi.org/project/comtypes/1.4.8/) can work with Python 3.13.
 - Version [1.4.6](https://pypi.org/project/comtypes/1.4.6/) is the last version to support Python 3.7.
@@ -87,7 +83,7 @@ For as long as COM is not supported outside of Windows, there is no plan to port
 
 ### Q: Why does `cannot import name 'COMError' from '_ctypes'` error occur when using this package on platforms other than Windows?
 **A:** The [`_ctypes`](https://github.com/python/cpython/blob/main/Modules/_ctypes/_ctypes.c) is part of the internal implementation of the [`ctypes`](https://github.com/python/cpython/blob/main/Lib/ctypes/) standard library that exists for Python on all platforms.
-However, `COMError` and COM-related features are only implemented in Python for Windows.
+However, [`COMError`](https://docs.python.org/3/library/ctypes.html#ctypes.COMError) and COM-related features are only implemented in Python for Windows.
 
 In cross-platform software development, care must be taken to ensure that codebases that depend on `comtypes` do not execute in environments other than Windows.
 

{comtypes-1.4.16 → comtypes-1.5.0}/README.md

@@ -13,11 +13,7 @@
 
 `comtypes` requires Windows and Python 3.9 or later.
 
-- **Note about Python 3.15 and `enum` behavior**  
-  Starting with Python 3.15, the internal handling of `IntFlag`(`Flag`) values is planned to change:  
-  **Negative `IntFlag` members will be reinterpreted by masking them to the defined positive bit domain, instead of keeping their original negative literal values**.  
-  This can affect enumeration types generated by `comtypes` from COM type libraries. Action is needed to maintain literal evaluation.  
-  For details and ongoing discussion, see: [GH-894](https://github.com/enthought/comtypes/issues/894).
+- Version <= [1.4.17](https://pypi.org/project/comtypes/1.4.17/) has issues with enum behavior on Python 3.15 as reported in [GH-894](https://github.com/enthought/comtypes/issues/894). Version [1.5.0](https://pypi.org/project/comtypes/1.5.0/) supports Python 3.15.
 - Version [1.4.12](https://pypi.org/project/comtypes/1.4.12/) is the last version to support Python 3.8.
 - Version <= [1.4.7](https://pypi.org/project/comtypes/1.4.7/) does not work with Python 3.13 as reported in [GH-618](https://github.com/enthought/comtypes/issues/618). Version [1.4.8](https://pypi.org/project/comtypes/1.4.8/) can work with Python 3.13.
 - Version [1.4.6](https://pypi.org/project/comtypes/1.4.6/) is the last version to support Python 3.7.
@@ -67,7 +63,7 @@ For as long as COM is not supported outside of Windows, there is no plan to port
 
 ### Q: Why does `cannot import name 'COMError' from '_ctypes'` error occur when using this package on platforms other than Windows?
 **A:** The [`_ctypes`](https://github.com/python/cpython/blob/main/Modules/_ctypes/_ctypes.c) is part of the internal implementation of the [`ctypes`](https://github.com/python/cpython/blob/main/Lib/ctypes/) standard library that exists for Python on all platforms.
-However, `COMError` and COM-related features are only implemented in Python for Windows.
+However, [`COMError`](https://docs.python.org/3/library/ctypes.html#ctypes.COMError) and COM-related features are only implemented in Python for Windows.
 
 In cross-platform software development, care must be taken to ensure that codebases that depend on `comtypes` do not execute in environments other than Windows.
 

{comtypes-1.4.16 → comtypes-1.5.0}/comtypes/__init__.py

@@ -1,5 +1,5 @@
 # comtypes version numbers follow semver (http://semver.org/) and PEP 440
-__version__ = "1.4.16"
+__version__ = "1.5.0"
 
 try:
     from _ctypes import COMError  # noqa
@@ -18,22 +18,6 @@ import atexit
 import logging
 import sys
 
-if sys.version_info >= (3, 15):
-    import warnings
-
-    _PYVER = f"{sys.version_info.major}.{sys.version_info.minor}"
-    warnings.warn(
-        (
-            f"You are running 'comtypes' on Python {_PYVER}, where the behavior of "
-            "enum types (such as IntFlag) may differ from Python <= 3.14.\n"
-            f"It is recommended to use a version compatible with Python {_PYVER}.\n"
-            "See: https://github.com/enthought/comtypes/issues/894"
-        ),
-        FutureWarning,
-        stacklevel=2,
-    )
-
-
 # HACK: Workaround for projects that depend on this package
 # There should be several projects around the world that depend on this package
 # and indirectly reference the symbols of `ctypes` from `comtypes`.
@@ -53,8 +37,8 @@ else:
 
 from comtypes import patcher  # noqa
 from comtypes._npsupport import interop as npsupport  # noqa
-from comtypes._tlib_version_checker import _check_version  # noqa
-from comtypes.GUID import GUID
+from comtypes._tlib_version_checker import _check_version as _check_version  # noqa
+from comtypes.GUID import GUID as GUID
 
 _all_slice = slice(None, None, None)
 
@@ -198,31 +182,34 @@ com_coclass_registry: dict[str, type["CoClass"]] = {}
 # IDL stuff
 
 from comtypes._memberspec import (  # noqa
-    COMMETHOD,
-    DISPMETHOD,
-    DISPPROPERTY,
-    STDMETHOD,
-    defaultvalue,
-    dispid,
-    helpstring,
+    COMMETHOD as COMMETHOD,
+    DISPMETHOD as DISPMETHOD,
+    DISPPROPERTY as DISPPROPERTY,
+    STDMETHOD as STDMETHOD,
+    defaultvalue as defaultvalue,
+    dispid as dispid,
+    helpstring as helpstring,
 )
 
 ################################################################
 # IUnknown, the root of all evil...
 from comtypes._post_coinit import _shutdown
-from comtypes._post_coinit.unknwn import IUnknown  # noqa
+from comtypes._post_coinit.unknwn import IUnknown as IUnknown  # noqa
 
 atexit.register(_shutdown)
 
 ################################################################
 
-from comtypes._post_coinit.bstr import BSTR  # noqa
+from comtypes._post_coinit.bstr import BSTR as BSTR  # noqa
 
 
 ################################################################
 # IPersist is a trivial interface, which allows to ask an object about
 # its clsid.
-from comtypes._post_coinit.misc import IPersist, IServiceProvider  # noqa
+from comtypes._post_coinit.misc import (
+    IPersist as IPersist,
+    IServiceProvider as IServiceProvider,
+)  # noqa
 
 
 ################################################################
@@ -232,39 +219,39 @@ from comtypes._post_coinit.instancemethod import instancemethod  # noqa
 from comtypes._post_coinit.activeobj import (  # noqa
     ACTIVEOBJECT_STRONG,
     ACTIVEOBJECT_WEAK,
-    GetActiveObject,
+    GetActiveObject as GetActiveObject,
     RegisterActiveObject,
     RevokeActiveObject,
 )
 from comtypes._post_coinit.misc import (  # noqa
     _is_object,
-    CoGetObject,
-    CoCreateInstance,
-    CoGetClassObject,
-    MULTI_QI,
+    CoGetObject as CoGetObject,
+    CoCreateInstance as CoCreateInstance,
+    CoGetClassObject as CoGetClassObject,
+    MULTI_QI as MULTI_QI,
     _COAUTHIDENTITY,
-    COAUTHIDENTITY,
+    COAUTHIDENTITY as COAUTHIDENTITY,
     _COAUTHINFO,
-    COAUTHINFO,
+    COAUTHINFO as COAUTHINFO,
     _COSERVERINFO,
-    COSERVERINFO,
+    COSERVERINFO as COSERVERINFO,
     _CoGetClassObject,
-    tagBIND_OPTS,
-    BIND_OPTS,
-    tagBIND_OPTS2,
-    BINDOPTS2,
+    tagBIND_OPTS as tagBIND_OPTS,
+    BIND_OPTS as BIND_OPTS,
+    tagBIND_OPTS2 as tagBIND_OPTS2,
+    BINDOPTS2 as BINDOPTS2,
     _SEC_WINNT_AUTH_IDENTITY,
-    SEC_WINNT_AUTH_IDENTITY,
+    SEC_WINNT_AUTH_IDENTITY as SEC_WINNT_AUTH_IDENTITY,
     _SOLE_AUTHENTICATION_INFO,
-    SOLE_AUTHENTICATION_INFO,
+    SOLE_AUTHENTICATION_INFO as SOLE_AUTHENTICATION_INFO,
     _SOLE_AUTHENTICATION_LIST,
-    SOLE_AUTHENTICATION_LIST,
-    CoCreateInstanceEx,
+    SOLE_AUTHENTICATION_LIST as SOLE_AUTHENTICATION_LIST,
+    CoCreateInstanceEx as CoCreateInstanceEx,
 )
 
 
 ################################################################
-from comtypes._comobject import COMObject
+from comtypes._comobject import COMObject as COMObject
 
 # What's a coclass?
 # a POINTER to a coclass is allowed as parameter in a function declaration:

{comtypes-1.4.16 → comtypes-1.5.0}/comtypes/_memberspec.py

@@ -165,19 +165,88 @@ class dispid(int):
 # instances with more methods or properties, and should not behave as an unpackable.
 
 
-def STDMETHOD(restype, name, argtypes=()) -> _ComMemberSpec:
-    "Specifies a COM method slot without idlflags"
-    return _ComMemberSpec(restype, name, argtypes, None, (), None)
-
-
-def DISPMETHOD(idlflags, restype, name, *argspec) -> _DispMemberSpec:
-    "Specifies a method of a dispinterface"
-    return _DispMemberSpec("DISPMETHOD", name, tuple(idlflags), restype, argspec)
+def STDMETHOD(
+    restype: Optional[type["_CDataType"]],
+    name: str,
+    argtypes: Sequence[type["_CDataType"]] = (),
+) -> _ComMemberSpec:
+    """Specifies a COM method slot without idlflags.
+
+    Use this when the method requires no parameter direction annotations
+    (`'in'`, `'out'`, etc.) and no helpstring.  If any of those are
+    needed, use `COMMETHOD` instead.
+
+    Args:
+        restype: The return type of the vtable method.  Typically
+            `HRESULT` or a primitive `ctypes` type.
+            Pass `None` when the method is declared `void`.
+        name: The name of the COM method.
+        argtypes: A sequence of `ctypes` types describing the raw
+            parameters of the vtable slot, in declaration order.
+            Defaults to an empty sequence when the method takes no
+            parameters.
+    """
+    return _ComMemberSpec(restype, name, tuple(argtypes), None, (), None)
+
+
+def DISPMETHOD(
+    idlflags: Sequence[_UnionT[int, str]],
+    restype: Optional[type["_CDataType"]],
+    name: str,
+    *argspec: "hints.ArgSpecElmType",
+) -> _DispMemberSpec:
+    """Specifies a method of a dispinterface.
+
+    Args:
+        idlflags: A sequence that describes the method itself.
+            Must contain a `dispid` instance (an `int` subclass) that
+            carries the `DISPID` of this member.  May also contain string
+            flags that control how the method is exposed.
+        restype: The return type of the dispatch method as a `ctypes`
+            type, or `None` when the method returns nothing (`void`).
+        name: The name of the dispatch method.
+        argspec: Zero or more argument specifiers, each describing one
+            parameter of the method. Each element is a tuple that can be:
+            - `(flags, type)` for a parameter with no name.
+            - `(flags, type, name)` for a named parameter.
+            - `(flags, type, name, default)` for a named parameter with
+                a default value.
+            - `flags` is a list of strings chosen from `'in'`, `'out'`,
+                `'lcid'`, `'retval'`, and `'optional'`.
+                Pass `[]` for a plain input parameter with no special
+                attributes.
+    """
+    return _DispMemberSpec(
+        "DISPMETHOD",
+        name,
+        tuple(idlflags),  # type: ignore
+        restype,
+        argspec,
+    )
 
 
-def DISPPROPERTY(idlflags, proptype, name) -> _DispMemberSpec:
-    "Specifies a property of a dispinterface"
-    return _DispMemberSpec("DISPPROPERTY", name, tuple(idlflags), proptype, ())
+def DISPPROPERTY(
+    idlflags: Sequence[_UnionT[int, str]],
+    proptype: type["_CDataType"],
+    name: str,
+) -> _DispMemberSpec:
+    """Specifies a property of a dispinterface.
+
+    Args:
+        idlflags: A sequence that describes the property itself.  Must
+            contain a `dispid` instance (a subclass of `int`) that
+            carries the `DISPID` of this member.  May also contain string
+            flags that control how the property is exposed.
+        proptype: The `ctypes` type of the property value.
+        name: The name of the dispatch property.
+    """
+    return _DispMemberSpec(
+        "DISPPROPERTY",
+        name,
+        tuple(idlflags),  # type: ignore
+        proptype,
+        (),
+    )
 
 
 # tuple(idlflags) is for the method itself: (dispid, 'readonly')
@@ -189,10 +258,38 @@ def DISPPROPERTY(idlflags, proptype, name) -> _DispMemberSpec:
 #     )
 
 
-def COMMETHOD(idlflags, restype, methodname, *argspec) -> _ComMemberSpec:
+def COMMETHOD(
+    idlflags: Sequence[_UnionT[int, str]],
+    restype: Optional[type["_CDataType"]],
+    methodname: str,
+    *argspec: "hints.ArgSpecElmType",
+) -> _ComMemberSpec:
     """Specifies a COM method slot with idlflags.
 
-    XXX should explain the sematics of the arguments.
+    Args:
+        idlflags: A sequence that describes the method or property itself.
+            Elements may be:
+            - String flags that control how the slot is exposed.
+            - A `helpstring` instance (a `str` subclass) whose
+              text is used as the method's docstring.
+            - A `dispid` instance (an `int` subclass) that
+              carries the `DISPID` when the method is part of a dual
+              interface.
+            - Pass `[]` for a regular vtable method with no special
+              attributes.
+        restype: The return type of the vtable method.  Typically
+            `HRESULT`.  Pass `None` when the method is `void`.
+        methodname: The name of the COM method or property.
+        argspec: Zero or more argument specifiers, each describing one
+            parameter of the method. Each element is a tuple that can be:
+            - `(flags, type)` for a parameter with no name.
+            - `(flags, type, name)` for a named parameter.
+            - `(flags, type, name, default)` for a named parameter with
+                a default value.
+            - `flags` is a list of strings chosen from `'in'`, `'out'`,
+                `'lcid'`, `'retval'`, and `'optional'`.
+                Pass `[]` for a plain input parameter with no special
+                attributes.
     """
     # collect all helpstring instances
     # We should suppress docstrings when Python is started with -OO
@@ -208,7 +305,12 @@ def COMMETHOD(idlflags, restype, methodname, *argspec) -> _ComMemberSpec:
     else:
         name = methodname
     return _ComMemberSpec(
-        restype, name, argtypes, paramflags, tuple(idlflags), helptext
+        restype,
+        name,
+        argtypes,
+        paramflags,
+        tuple(idlflags),  # type: ignore
+        helptext,
     )
 
 

{comtypes-1.4.16 → comtypes-1.5.0}/comtypes/_post_coinit/misc.py

@@ -14,6 +14,7 @@ from ctypes import (
 )
 from ctypes.wintypes import DWORD, LPCWSTR, LPVOID
 from typing import TYPE_CHECKING, Any, Optional, TypeVar, overload
+from typing import Union as _UnionT
 
 from comtypes import CLSCTX_LOCAL_SERVER, CLSCTX_REMOTE_SERVER, CLSCTX_SERVER, GUID
 from comtypes._memberspec import COMMETHOD
@@ -21,7 +22,7 @@ from comtypes._post_coinit.unknwn import IUnknown
 from comtypes.GUID import REFCLSID
 
 if TYPE_CHECKING:
-    from ctypes import _Pointer
+    from ctypes import _CArgObject, _Pointer
 
     from comtypes import hints as hints  # noqa  # type: ignore
 
@@ -146,20 +147,20 @@ def CoCreateInstance(
 def CoGetClassObject(
     clsid: GUID,
     clsctx: Optional[int] = None,
-    pServerInfo: "Optional[COSERVERINFO]" = None,
+    pServerInfo: "_UnionT[None, _CArgObject, COSERVERINFO]" = None,
     interface: None = None,
 ) -> "hints.IClassFactory": ...
 @overload
 def CoGetClassObject(
     clsid: GUID,
     clsctx: Optional[int] = None,
-    pServerInfo: "Optional[COSERVERINFO]" = None,
+    pServerInfo: "_UnionT[None, _CArgObject, COSERVERINFO]" = None,
     interface: type[_T_IUnknown] = IUnknown,
 ) -> _T_IUnknown: ...
 def CoGetClassObject(
     clsid: GUID,
     clsctx: Optional[int] = None,
-    pServerInfo: "Optional[COSERVERINFO]" = None,
+    pServerInfo: "_UnionT[None, _CArgObject, COSERVERINFO]" = None,
     interface: Optional[type[IUnknown]] = None,
 ) -> IUnknown:
     if clsctx is None:
@@ -337,7 +338,7 @@ def CoCreateInstanceEx(
     interface: None = None,
     clsctx: Optional[int] = None,
     machine: Optional[str] = None,
-    pServerInfo: Optional[COSERVERINFO] = None,
+    pServerInfo: "_UnionT[None, _CArgObject, COSERVERINFO]" = None,
 ) -> IUnknown: ...
 @overload
 def CoCreateInstanceEx(
@@ -345,14 +346,14 @@ def CoCreateInstanceEx(
     interface: type[_T_IUnknown],
     clsctx: Optional[int] = None,
     machine: Optional[str] = None,
-    pServerInfo: Optional[COSERVERINFO] = None,
+    pServerInfo: "_UnionT[None, _CArgObject, COSERVERINFO]" = None,
 ) -> _T_IUnknown: ...
 def CoCreateInstanceEx(
     clsid: GUID,
     interface: Optional[type[IUnknown]] = None,
     clsctx: Optional[int] = None,
     machine: Optional[str] = None,
-    pServerInfo: Optional[COSERVERINFO] = None,
+    pServerInfo: "_UnionT[None, _CArgObject, COSERVERINFO]" = None,
 ) -> IUnknown:
     """The basic windows api to create a COM class object and return a
     pointer to an interface, possibly on another machine.

{comtypes-1.4.16 → comtypes-1.5.0}/comtypes/_safearray.py

@@ -1,10 +1,16 @@
 """SAFEARRAY api functions, data types, and constants."""
 
-from ctypes import POINTER, Structure, WinDLL, c_uint, c_ushort, c_void_p
+from ctypes import POINTER, Structure, WinDLL, byref, c_uint, c_ushort, c_void_p
 from ctypes.wintypes import DWORD, LONG, UINT, USHORT
+from typing import TYPE_CHECKING
 
 from comtypes import GUID, HRESULT
 
+if TYPE_CHECKING:
+    from ctypes import _Pointer
+
+    from comtypes import hints  # type: ignore
+
 ################################################################
 # if __debug__:
 #     from ctypeslib.dynamic_module import include
@@ -78,6 +84,31 @@ def SafeArrayGetVartype(pa):
     return result.value
 
 
+_SafeArrayGetRecordInfo = _oleaut32.SafeArrayGetRecordInfo
+_SafeArrayGetRecordInfo.restype = HRESULT
+_SafeArrayGetRecordInfo.argtypes = [POINTER(SAFEARRAY), POINTER(c_void_p)]
+
+
+def SafeArrayGetRecordInfo(pa: "_Pointer[tagSAFEARRAY]") -> "hints.IRecordInfo":
+    # Defined here to avoid a circular import
+    from comtypes.typeinfo import IRecordInfo
+
+    result = POINTER(IRecordInfo)()
+    _SafeArrayGetRecordInfo(pa, byref(result))
+    return result  # type: ignore
+
+
+_SafeArrayCopy = _oleaut32.SafeArrayCopy
+_SafeArrayCopy.restype = HRESULT
+_SafeArrayCopy.argtypes = [POINTER(SAFEARRAY), POINTER(POINTER(SAFEARRAY))]
+
+
+def SafeArrayCopy(pa: "_Pointer[SAFEARRAY]") -> "hints.LP_SAFEARRAY":
+    result = POINTER(SAFEARRAY)()
+    _SafeArrayCopy(pa, byref(result))
+    return result  # type: ignore
+
+
 SafeArrayGetElement = _oleaut32.SafeArrayGetElement
 SafeArrayGetElement.restype = HRESULT
 SafeArrayGetElement.argtypes = [POINTER(SAFEARRAY), POINTER(LONG), c_void_p]