CALLFRAME_FREE Enumeration (callobj.h)

  • Artikel
  • 2 Minuten Lesedauer

Bestimmt den Parametertyp, der freizugeben ist.

Syntax

typedef enum CALLFRAME_FREE {
  CALLFRAME_FREE_NONE = 0,
  CALLFRAME_FREE_IN = 1,
  CALLFRAME_FREE_INOUT = 2,
  CALLFRAME_FREE_OUT = 4,
  CALLFRAME_FREE_TOP_INOUT = 8,
  CALLFRAME_FREE_TOP_OUT = 16,
  CALLFRAME_FREE_ALL = 31
} ;

Konstanten

 
CALLFRAME_FREE_NONE
Wert: 0
Es werden keine Werte freigestellt.
CALLFRAME_FREE_IN
Wert: 1
Die Parameter [in] werden freigestellt. Dies umfasst sowohl Top-Level-Zeiger als auch die Daten, auf die sie verweisen.
CALLFRAME_FREE_INOUT
Wert: 2
Die von [in, out] referenzierten Daten werden freigestellt. Die Zeiger auf oberster Ebene, die die tatsächlichen Parameterwerte sind, werden jedoch nicht freigestellt.

Auf der Serverseite wird dies in der Regel nach dem Aufruf verwendet, wie in CALLFRAME_FREE_IN. Auf der clientseitigen Seite wird dies in der Regel verwendet, wenn der Server nicht tatsächlich aufgerufen wurde (und daher wurde das Nichtmarshaling von Rückgabewerten nicht versucht) oder wenn die Entmarung der Rückgabewerte fehlgeschlagen ist.
CALLFRAME_FREE_OUT
Wert: 4
Die von [out]-Parametern verwiesenen Daten werden freigestellt. Die Zeiger auf oberster Ebene, die die tatsächlichen Parameterwerte sind, werden jedoch nicht freigestellt.

Auf der Serverseite wird dies in der Regel nach dem Aufruf verwendet, wie in CALLFRAME_FREE_IN. Auf der Clientseite wird dies in der Regel nur verwendet, wenn die Entmarung von Rückgabewerten fehlgeschlagen ist.
CALLFRAME_FREE_TOP_INOUT
Wert: 8
Die Parameter [in, out] werden freigestellt. Dies umfasst sowohl Top-Level-Zeiger als auch die Daten, auf die sie verweisen.
CALLFRAME_FREE_TOP_OUT
Wert: 16
Die Parameter [out] werden freigestellt. Dies umfasst sowohl Top-Level-Zeiger als auch die Daten, auf die sie verweisen.
CALLFRAME_FREE_ALL
Wert: 31
Alle Parameter [in], [out] und [in, out] werden freigestellt. Dies umfasst sowohl Top-Level-Zeiger als auch die Daten, auf die sie verweisen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Header callobj.h

Weitere Informationen

ICallFrame::Kostenlos

ICallFrame::FreeParam