Marshal.DestroyStructure 方法

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

多載

DestroyStructure(IntPtr, Type)	釋放指定之 Unmanaged 記憶體區塊指向的所有子結構。
DestroyStructure<T>(IntPtr)	釋放指定之 Unmanaged 記憶體區塊指向的所有指定類型的子結構。

DestroyStructure(IntPtr, Type)

來源:

Marshal.cs

釋放指定之 Unmanaged 記憶體區塊指向的所有子結構。

public:
 static void DestroyStructure(IntPtr ptr, Type ^ structuretype);

public static void DestroyStructure (IntPtr ptr, Type structuretype);

static member DestroyStructure : nativeint * Type -> unit

Public Shared Sub DestroyStructure (ptr As IntPtr, structuretype As Type)

參數

ptr

IntPtr

nativeint

Unmanaged 記憶體區塊的指標。

structuretype

Type

格式化類別的類型。 這提供刪除 ptr 中的緩衝區時所必須的配置資訊。

例外狀況

ArgumentException

structureType 有自動配置。 使用循序或明確取代。

備註

您可以使用這個方法來釋放 Unmanaged 結構的參考型別欄位，例如字串。 與其欄位不同，結構可以是實值型別或參考型別。 包含實值型別字段的實數值型別結構， (所有 blittable) 沒有必須釋放其記憶體的參考。 方法 Marshal.StructureToPtr 會使用這個方法來防止重複使用結構所佔用的記憶體時發生記憶體流失。

DestroyStructure 會呼叫 COM SysFreeString 函式，接著釋放配置的字串。

除了 DestroyStructure 之外，類別 Marshal 還提供兩個其他記憶體解除配置方法： FreeCoTaskMem 和 FreeHGlobal 。

另請參閱

• FreeCoTaskMem(IntPtr)
• FreeHGlobal(IntPtr)
• Blittable 和非 Blittable 類型

DestroyStructure<T>(IntPtr)

來源:

Marshal.cs

釋放指定之 Unmanaged 記憶體區塊指向的所有指定類型的子結構。

public:
generic <typename T>
 static void DestroyStructure(IntPtr ptr);

public static void DestroyStructure<T> (IntPtr ptr);

static member DestroyStructure : nativeint -> unit

Public Shared Sub DestroyStructure(Of T) (ptr As IntPtr)

類型參數

T

格式化結構的類型。 這提供刪除 ptr 中的緩衝區時所必須的配置資訊。

參數

ptr

IntPtr

nativeint

Unmanaged 記憶體區塊的指標。

例外狀況

ArgumentException

T 有自動配置。 使用循序或明確取代。

備註

您可以使用這個方法來釋放非受控結構的參考型別字段，例如字串。 與其欄位不同，結構可以是實值型別或參考型別。 包含實值型別字段的值型別結構 (所有 blittable) 沒有必須釋放記憶體的參考。 方法 Marshal.StructureToPtr 會使用這個方法來防止重複使用結構所佔用的記憶體時發生記憶體流失。

DestroyStructure 會呼叫 COM SysFreeString 函式，接著釋放配置的字串。