Marshal.DestroyStructure Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Sobrecargas

DestroyStructure(IntPtr, Type)	Libera todas as subestruturas para as quais o bloco de memória não gerenciada especificado aponta.
DestroyStructure<T>(IntPtr)	Libera todas as subestruturas de um tipo especificado para as quais o bloco de memória não gerenciado especificado aponta.

DestroyStructure(IntPtr, Type)

Origem:

Marshal.CoreCLR.cs

Libera todas as subestruturas para as quais o bloco de memória não gerenciada especificado aponta.

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)

Parâmetros

ptr

IntPtr

nativeint

Um ponteiro para um bloco não gerenciado de memória.

structuretype

Type

Tipo de uma classe formatada. Isso fornece as informações de layout necessárias para excluir o buffer no parâmetro ptr.

Exceções

ArgumentException

structureType tem um layout automático. Use explícito ou sequencial no seu lugar.

Comentários

Você pode usar esse método para liberar campos de tipo de referência, como cadeias de caracteres, de uma estrutura não gerenciada. Ao contrário de seus campos, uma estrutura pode ser um tipo de valor ou um tipo de referência. Estruturas de tipo de valor que contêm campos de tipo de valor (todos blittable) não têm referências cuja memória deve ser liberada. O Marshal.StructureToPtr método usa esse método para evitar vazamentos de memória ao reutilização da memória ocupada por uma estrutura.

DestroyStructure chama a função COM SysFreeString , que, por sua vez, libera uma cadeia de caracteres alocada.

Além de DestroyStructure, a Marshal classe fornece dois outros métodos de desalocação de memória: FreeCoTaskMem e FreeHGlobal.

Confira também

• FreeCoTaskMem(IntPtr)
• FreeHGlobal(IntPtr)
• Tipos Blittable e Não Blittable

DestroyStructure<T>(IntPtr)

Origem:

Marshal.cs

Libera todas as subestruturas de um tipo especificado para as quais o bloco de memória não gerenciado especificado aponta.

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)

Parâmetros de tipo

T

O tipo da estrutura formatada. Isso fornece as informações de layout necessárias para excluir o buffer no parâmetro ptr.

Parâmetros

ptr

IntPtr

nativeint

Um ponteiro para um bloco não gerenciado de memória.

Exceções

ArgumentException

T tem um layout automático. Use explícito ou sequencial no seu lugar.

Comentários

Você pode usar esse método para liberar campos de tipo de referência, como cadeias de caracteres, de uma estrutura não gerenciada. Ao contrário de seus campos, uma estrutura pode ser um tipo de valor ou um tipo de referência. As estruturas de tipo de valor que contêm campos de tipo de valor (todos blittable) não têm referências cuja memória deve ser liberada. O Marshal.StructureToPtr método usa esse método para evitar vazamentos de memória ao reutilização da memória ocupada por uma estrutura.

DestroyStructure chama a função COM SysFreeString , que, por sua vez, libera uma cadeia de caracteres alocada.