Class ITypeComp

comtypes/typeinfo.py:428–472

class ITypeComp(IUnknown):
    _iid_ = GUID("{00020403-0000-0000-C000-000000000046}")

    def Bind(
        self, name: str, flags: int = 0, lHashVal: int = 0
    ) -> _UnionT[
        tuple[Literal["function"], "FUNCDESC"],
        tuple[Literal["variable"], "VARDESC"],
        tuple[Literal["type"], "ITypeComp"],
        None,
    ]:
        """Bind to a name"""
        bindptr = BINDPTR()
        desckind = DESCKIND()
        ti: ITypeInfo = POINTER(ITypeInfo)()  # type: ignore
        self.__com_Bind(  # type: ignore
            name, lHashVal, flags, byref(ti), byref(desckind), byref(bindptr)
        )
        kind = desckind.value
        if kind == DESCKIND_FUNCDESC:
            fd = _deref_with_release(bindptr.lpfuncdesc, ti.ReleaseFuncDesc)
            return "function", fd
        elif kind == DESCKIND_VARDESC:
            vd = _deref_with_release(bindptr.lpvardesc, ti.ReleaseVarDesc)
            return "variable", vd
        elif kind == DESCKIND_TYPECOMP:
            return "type", bindptr.lptcomp
        elif kind == DESCKIND_IMPLICITAPPOBJ:
            # `DESCKIND_IMPLICITAPPOBJ` is rare; mainly for Office Application.
            # It indicates a global application object (`TYPEFLAG_FAPPOBJECT`).
            # Few other COM components use this highly specialized flag.
            # Thus, this path is unlikely to be hit in common scenarios.
            raise NotImplementedError
        elif kind == DESCKIND_NONE:
            raise NameError("Name %s not found" % name)
        # `DESCKIND_MAX` is an end-of-enumeration marker, not a valid return
        # from `ITypeComp::Bind` in COM. If returned, it implies a malformed
        # type library. The current implementation implicitly returns `None`.

    def BindType(self, name: str, lHashVal: int = 0) -> tuple[ITypeInfo, "ITypeComp"]:
        """Bind a type, and return both the typeinfo and typecomp for it."""
        ti = POINTER(ITypeInfo)()
        tc = POINTER(ITypeComp)()
        self.__com_BindType(name, lHashVal, byref(ti), byref(tc))  # type: ignore
        return ti, tc  # type: ignore


################