Marshal.DestroyStructure Methode

  • Referenz

Definition

Namespace:
System.Runtime.InteropServices
Assembly:
System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Überlädt

DestroyStructure(IntPtr, Type)
Veraltet.

Gibt alle Unterstrukturen frei, auf die der angegebene nicht verwaltete Speicherblock zeigt.
DestroyStructure<T>(IntPtr)

Gibt alle Unterstrukturen eines angegebenen Typs frei, auf die der angegebene nicht verwaltete Speicherblock zeigt.

DestroyStructure(IntPtr, Type)

Quelle:
Marshal.cs
Quelle:
Marshal.cs
Quelle:
Marshal.CoreCLR.cs

Achtung

DestroyStructure(IntPtr, Type) may be unavailable in future releases. Instead, use DestroyStructure<T>(IntPtr). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296520

Gibt alle Unterstrukturen frei, auf die der angegebene nicht verwaltete Speicherblock zeigt.

public:
 static void DestroyStructure(IntPtr ptr, Type ^ structuretype);
[System.Obsolete("DestroyStructure(IntPtr, Type) may be unavailable in future releases. Instead, use DestroyStructure<T>(IntPtr). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296520")]
[System.Security.SecurityCritical]
public static void DestroyStructure (IntPtr ptr, Type structuretype);
public static void DestroyStructure (IntPtr ptr, Type structuretype);
[System.Security.SecurityCritical]
public static void DestroyStructure (IntPtr ptr, Type structuretype);
[System.Runtime.InteropServices.ComVisible(true)]
public static void DestroyStructure (IntPtr ptr, Type structuretype);
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(true)]
public static void DestroyStructure (IntPtr ptr, Type structuretype);
[<System.Obsolete("DestroyStructure(IntPtr, Type) may be unavailable in future releases. Instead, use DestroyStructure<T>(IntPtr). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296520")>]
[<System.Security.SecurityCritical>]
static member DestroyStructure : nativeint * Type -> unit
static member DestroyStructure : nativeint * Type -> unit
[<System.Security.SecurityCritical>]
static member DestroyStructure : nativeint * Type -> unit
[<System.Runtime.InteropServices.ComVisible(true)>]
static member DestroyStructure : nativeint * Type -> unit
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(true)>]
static member DestroyStructure : nativeint * Type -> unit
Public Shared Sub DestroyStructure (ptr As IntPtr, structuretype As Type)

Parameter

ptr
IntPtr

nativeint

Ein Zeiger auf einen nicht verwalteten Speicherblock.

structuretype
Type

Typ einer formatierten Klasse. Damit werden die Layoutinformationen bereitgestellt, die zum Löschen des Puffers im ptr-Parameter benötigt werden.

Attribute
ObsoleteAttribute SecurityCriticalAttribute ComVisibleAttribute

Ausnahmen

ArgumentException

structureType weist ein automatisch angelegtes Layout auf. Verwenden Sie stattdessen sequenzielles oder explizites Layout.

Hinweise

Sie können diese Methode verwenden, um Verweistypfelder, z. B. Zeichenfolgen, von einer nicht verwalteten Struktur freizugeben. Im Gegensatz zu ihren Feldern kann eine Struktur ein Werttyp oder ein Verweistyp sein. Werttypstrukturen, die Werttypfelder (alle blittierbar) enthalten, weisen keine Verweise auf, deren Arbeitsspeicher freigegeben werden muss. Die Marshal.StructureToPtr Methode verwendet diese Methode, um Speicherverluste bei der Wiederverwendung von Speicher zu verhindern, der von einer Struktur belegt ist.

DestroyStructure ruft die COM SysFreeString-Funktion auf, die wiederum eine zugeordnete Zeichenfolge freigibt.

Zusätzlich stellt DestroyStructuredie Marshal -Klasse zwei weitere Speicherdeallocation-Methoden bereit: FreeCoTaskMem und FreeHGlobal.

Weitere Informationen

Gilt für:

DestroyStructure<T>(IntPtr)

Quelle:
Marshal.cs
Quelle:
Marshal.cs
Quelle:
Marshal.cs

Gibt alle Unterstrukturen eines angegebenen Typs frei, auf die der angegebene nicht verwaltete Speicherblock zeigt.

public:
generic <typename T>
 static void DestroyStructure(IntPtr ptr);
[System.Security.SecurityCritical]
public static void DestroyStructure<T> (IntPtr ptr);
public static void DestroyStructure<T> (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member DestroyStructure : nativeint -> unit
static member DestroyStructure : nativeint -> unit
Public Shared Sub DestroyStructure(Of T) (ptr As IntPtr)

Typparameter

T

Der Typ der formatierten Struktur. Damit werden die Layoutinformationen bereitgestellt, die zum Löschen des Puffers im ptr-Parameter benötigt werden.

Parameter

ptr
IntPtr

nativeint

Ein Zeiger auf einen nicht verwalteten Speicherblock.

Attribute
SecurityCriticalAttribute

Ausnahmen

ArgumentException

T weist ein automatisch angelegtes Layout auf. Verwenden Sie stattdessen sequenzielles oder explizites Layout.

Hinweise

Sie können diese Methode verwenden, um Verweistypfelder, z. B. Zeichenfolgen, von einer nicht verwalteten Struktur freizugeben. Im Gegensatz zu ihren Feldern kann eine Struktur ein Werttyp oder ein Verweistyp sein. Werttypstrukturen, die Werttypfelder (alle blittable) enthalten, weisen keine Verweise auf, deren Arbeitsspeicher freigegeben werden muss. Die Marshal.StructureToPtr Methode verwendet diese Methode, um Speicherverluste bei der Wiederverwendung von Speicher zu verhindern, der von einer Struktur belegt ist.

DestroyStructure ruft die COM SysFreeString-Funktion auf, die wiederum eine zugeordnete Zeichenfolge freigibt.

Gilt für: