ICallFrame-Schnittstelle (callobj.h)
Ermöglicht die Bearbeitung von Aufrufframes, z. B. Stapelframes. Der Aufrufrahmen ist der Text der Informationen, die eine Prozedur speichern muss, damit sie ordnungsgemäß zu ihrem Aufrufer zurückkehren kann. Ein Aufrufframe kann im Stapel oder in Registern vorhanden sein. Ein Stapelrahmen verwaltet die Kontextinformationen des Aufrufers auf dem Stapel.
Ein instance der ICallFrame-Schnittstelle kann verschiedene Transformationen für einen Aufrufframe ausführen. Der Aufruf kann gemarshallt oder beibehalten werden. Der instance dieser Schnittstelle ist gebunden und weist eine zugeordnete Methodennummer auf.
Vererbung
Die ICallFrame-Schnittstelle erbt von der IUnknown-Schnittstelle . ICallFrame verfügt auch über folgende Arten von Membern:
Methoden
Die ICallFrame-Schnittstelle verfügt über diese Methoden.
| ICallFrame::Copy Erstellt eine Kopie dieses Aufrufrahmens und aller zugehörigen Daten. |
| ICallFrame::Free Gibt die Framekopie frei, um einen Speicherverlust zu vermeiden. |
| ICallFrame::FreeParam Gibt den angegebenen Parameter im Frame frei. |
| ICallFrame::GetIIDAndMethod Ruft die Schnittstellen-ID oder die Methodennummer ab. |
| ICallFrame::GetInfo Ruft Informationen zum Aufrufframe ab. |
| ICallFrame::GetMarshalSizeMax Ruft eine Obergrenze für die Anzahl von Bytes ab, die zum Marshallen des Aufrufframes erforderlich sind. |
| ICallFrame::GetNames Ruft den Methoden- oder Schnittstellennamen dieses Aufrufs ab. |
| ICallFrame::GetParam Ruft den Wert eines angegebenen Parameters im Aufrufframe ab. |
| ICallFrame::GetParamInfo Ruft die Informationen für den angegebenen Parameter ab. |
| ICallFrame::GetReturnValue Ruft den im Aufrufframe gespeicherten Rückgabewert ab. |
| ICallFrame::GetStackLocation Ruft den Stapelspeicherort ab, an den dieser Aufrufrahmen gebunden ist. |
| ICallFrame::Invoke Wendet diesen Aktivierungsdatensatz auf ein -Objekt an. In einer Marshallingsituation wird dies in der Regel auf der Serverseite ausgeführt und ist das Mittel, mit dem die Arbeit des eigentlichen Objekts erreicht wird. |
| ICallFrame::Marshal Marshallt den Aufrufrahmen, indem die erreichbaren Daten in einen flachen Puffer umgewandelt werden, ohne den Frame zu stören. |
| ICallFrame::ReleaseMarshalData Gibt Ressourcen frei, die von Schnittstellenzeigern in einem Paket gemarshallter Daten gespeichert werden. Diese Methode findet alle Schnittstellenzeiger im Paket und ruft die CoReleaseMarshalData-Funktion auf. |
| ICallFrame::SetParam Legt den Wert eines angegebenen Parameters im Aufrufframe fest. |
| ICallFrame::SetReturnValue Legt den Rückgabewert innerhalb des Aufrufrahmens fest. |
| ICallFrame::SetStackLocation Legt die Stapelposition fest, an die dieser Aufrufrahmen gebunden ist. |
| ICallFrame::Unmarshal Hebt ein Datenpaket auf, das die zuvor gemarshallten [out]-Parameter eines Aufrufs in diesen bereits vorhandenen Aktivierungsdatensatz enthält. |
| ICallFrame::WalkFrame Sucht nach Schnittstellenzeigern, die über die Parameter [in, out] oder [out] des Frames erreichbar sind. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | callobj.h |