Libera todas las subestructuras a las que apunta el bloque de memoria no administrada especificado.
Espacio de nombres: System.Runtime.InteropServices
Ensamblado: mscorlib (en mscorlib.dll)
Sintaxis
Visual Basic (Declaración)
<ComVisibleAttribute(True)> _
Public Shared Sub DestroyStructure ( _
ptr As IntPtr, _
structuretype As Type _
)
Dim ptr As IntPtr
Dim structuretype As Type
Marshal.DestroyStructure(ptr, structuretype)
[ComVisibleAttribute(true)]
public static void DestroyStructure (
IntPtr ptr,
Type structuretype
)
[ComVisibleAttribute(true)]
public:
static void DestroyStructure (
IntPtr ptr,
Type^ structuretype
)
/** @attribute ComVisibleAttribute(true) */
public static void DestroyStructure (
IntPtr ptr,
Type structuretype
)
ComVisibleAttribute(true)
public static function DestroyStructure (
ptr : IntPtr,
structuretype : Type
)
Parámetros
- ptr
Puntero a un bloque de memoria no administrado.
- structuretype
Tipo de una clase con formato. Proporciona la información de diseño necesaria para eliminar el búfer del parámetro ptr.
Excepciones
| Tipo de excepción | Condición |
|---|
ArgumentException | structureType tiene un diseño automático. Utilice, en su lugar, un diseño secuencial o explícito. |
Comentarios
Puede utilizar este método para liberar los campos de tipo de referencia, como las cadenas, de una estructura no administrada. A diferencia de sus campos, una estructura puede ser un tipo de valor o un tipo de referencia. Las estructuras de tipo de valor que contienen campos de tipo de valor (todos ellos representables como bits/bytes) no tienen referencias cuya memoria deba liberarse. StructureToPtr utiliza este método para evitar pérdidas de memoria cuando se reutiliza la memoria ocupada por una estructura.
DestroyStructure llama al método SysFreeString de la API de COM que, a su vez, libera una cadena asignada. Para obtener más información sobre SysFreeString, vea MSDN Library.
Además de DestroyStructure, la clase Marshal proporciona otros dos métodos de desasignación de memoria: Marshal.FreeCoTaskMem y Marshal.FreeHGlobal.
.gif) Nota |
|---|
| Este método utiliza SecurityAction.LinkDemand para evitar que se le llame desde código que no sea de confianza; sólo el llamador inmediato debe disponer del permiso SecurityPermissionAttribute.UnmanagedCode. Si se puede llamar al código desde código de confianza parcial, no pase ninguna entrada de usuario a los métodos de la clase Marshal sin validación. Para conocer las limitaciones importantes que existen a la hora de utilizar el miembro LinkDemand, vea Demand frente a LinkDemand. |
Seguridad de .NET Framework
Plataformas
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
Información de versión
.NET Framework
Compatible con: 2.0, 1.1, 1.0
Vea también