C#——Marshal.StructureToPtr方法简介

本博客（ http://blog.csdn.net/livelylittlefish）贴出作者（三二一、小鱼）相关研究、学习内容所做的笔记，欢

迎广大朋友指正！

                                            

                                            

具体可以参考 http://msdn.microsoft.com。

                                            

                                            

Marshal.StructureToPtr方法简介

                                            

                                            

1. 功能及位置

                                            

                                            

将数据从托管对象封送到非托管内存块，属于.NET Framework 类库
命名空间：System.Runtime.InteropServices
程序集：mscorlib（在 mscorlib.dll 中）

                                            

                                            

2. 语法

                                            

                                            

C#：

      [ComVisibleAttribute(true)] public static void StructureToPtr (Object structure,IntPtr ptr,bool fDeleteOld);
C++：

      [ComVisibleAttribute(true)]public: static void StructureToPtr (Object^ structure, IntPtr ptr, bool fDeleteOld);

                                            

                                            

3. 参数说明

                                            

                                            

structure：托管对象，包含要封送的数据。该对象必须是格式化类的实例。
ptr：指向非托管内存块的指针，必须在调用此方法之前分配该指针。
fDeleteOld：设置为 true 可在执行Marshal.DestroyStructure方法前对 ptr 参数调用此方法。请注意，传递 false 可导致内存泄漏。

                                            

                                            

4. 异常

                                            

                                            

异常类型：ArgumentException
条件：structrue参数是泛型类型

                                            

                                            

5. 备注

                                            

                                            

StructureToPtr将结构的内容复制到 ptr 参数指向的预分配内存块。如果 fDeleteOld 参数为 true，则使用嵌入指

针上适当的删除 API 来删除最初由 ptr 指向的缓冲区，但该缓冲区必须包含有效数据。此方法为在镜像托管类中指

定的每个引用字段执行清理工作。

                                            

假设 ptr 指向非托管内存块。此内存块的布局由相应的托管类 structure 描述。StructureToPtr将字段值从结构封

送到指针。假设 ptr 块包含引用字段，该字段指向当前包含“abc”的字符串缓冲区。假设托管端上相应的字段是包含“vwxyz”的字符串。如果不另行通知它，StructureToPtr将分配一个新的非托管缓冲区来保存“vwxyz”，并将它挂钩到 ptr 块。这将丢弃旧缓冲区“abc”使之漂移而不将其释放回非托管堆。最后，您将得到一个孤立的缓冲区，它表示在代码中存在内存泄漏。如果将 fDeleteOld 参数设置为真，则 StructureToPtr 在继续为“vwxyz”分配新缓冲区之前释放保存“abc”的缓冲区。

                                            

                                            

6. 举例

                                            

                                            

定义PERSON结构，并将该结构的一个变量拷贝到非托管内存，再将该内存中的PERSON还原为PERSON对象，观察其内容的变化。

                                            

                                            

源代码如下：

                                            

                                            

using  System;
using  System.Text;
using  System.Runtime.InteropServices;

namespace  testStructureToPtr
... {
    public static class define  //define some constant
    ...{        
        public const int MAX_LENGTH_OF_IDENTICARDID = 20;   //maximum length of identicardid
        public const int MAX_LENGTH_OF_NAME <