Class ObjectInstance

scapy/layers/msrpce/msdcom.py:746–829

An reference to an instantiated object. This is a helper to manipulate this object and perform calls over it.

class ObjectInstance:
    """
    An reference to an instantiated object.

    This is a helper to manipulate this object and perform calls over it.
    """

    def __init__(self, client: "DCOM_Client", oid: int):
        self.client = client
        self.oid = oid

    def __repr__(self):
        return f"<ObjectInstance {self.oid}>"

    @property
    def valid(self):
        """
        Returns whether the current object still exists
        """
        return self.oid in self.client.OID_table

    @property
    def ndr64(self):
        """
        Whether NDR64 is required to talk to this object
        """
        return self.client.ndr64

    def sr1_req(
        self,
        pkt: NDRPacket,
        iface: ComInterface,
        ssp=None,
        auth_level=None,
        timeout=None,
        **kwargs,
    ):
        """
        Make an ORPC call on this object instance.

        :param iface: the ComInterface to call.
        :param pkt: the request to make.

        :param ssp: (optional) non default SSP to use to connect to the object exporter
        :param auth_level: (optional) non default authn level to use
        :param timeout: (optional) timeout for the connection
        """
        # Look for this object's entry
        try:
            oid_entry = self.client.OID_table[self.oid]
        except KeyError:
            raise ValueError("This object has been released.")

        # Look for the ipid matching the interface required by the user
        ipid = None
        for ipid in oid_entry.ipids:
            ipid_entry = self.client.IPID_table[ipid]
            if ipid_entry.iid == iface.uuid: