SafeArray使用.doc

本文档主要讲述的是SafeArray使用；SafeArray是VB中的数组存储方式。通过SafeArray，可以在VC++和VB间相互调用。SafeArray也是Automation中的标准数组存储方式。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看 SafeArray是Microsoft COM（组件对象模型）中的一种特殊数组类型，尤其在Visual Basic（VB）和Visual C++（VC++）之间进行互操作时扮演重要角色。它也被用于Automation技术，使得不同编程语言之间能够方便地传递数组数据。SafeArray的设计目的是确保数据的安全性和一致性，避免因直接操作数组内存而导致的问题。 ### SafeArray的使用 1. **创建SafeArray** - `SafeArrayCreate` 用于创建多维普通数组，支持各种基础数据类型。 - `SafeArrayCreateEx` 用于创建包含自定义类型或接口指针的多维数组。 - `SafeArrayCreateVector` 创建一维普通数组，适用于简单的线性数据。 - `SafeArrayCreateVectorEx` 创建一维数组，同样支持自定义类型或接口指针。 在创建SafeArray时，你需要指定数组的类型（VARTYPE），维度数以及每个维度的边界信息。例如，`SafeArrayCreateVector`函数接受类型（如VT_I4表示4字节整数）、下界（lLbound）和元素数量（cElements）作为参数。 2. **释放SafeArray** 一旦不再需要SafeArray，你可以使用`SafeArrayDestroy`函数来释放其占用的内存资源。 3. **访问SafeArray数据** - `SafeArrayAccessData` 允许你获取指向数组内部数据的指针，以便进行读写操作。调用此函数后，数组进入锁定状态，直到调用`SafeArrayUnaccessData`才解锁。 - `SafeArrayUnaccessData` 释放由`SafeArrayAccessData`获得的访问权限，解锁数组。 ### SafeArray的相关处理 1. **创建SafeArray数组** SafeArray的创建过程涉及到选择适当的创建函数，根据需要创建一维或多维数组。每个函数都有其特定的用途，比如`SafeArrayCreateVector`适合创建简单类型的一维数组，而`SafeArrayCreateVectorEx`则扩展了这种功能，允许创建包含复杂类型的数组。 2. **SafeArray的类型（VARTYPE）** SafeArray支持多种基础数据类型，包括： - VT_UI1：无符号1字节整数（BYTE） - VT_UI2：无符号2字节整数（WORD） - VT_UI4：无符号4字节整数（DWORD） - VT_UINT：无符号整数（UINT） - VT_INT：有符号整数（INT） - VT_I1：有符号1字节整数 - VT_I2：有符号2字节整数 - VT_I4：有符号4字节整数 - VT_R4：4字节浮点数（float） - VT_R8：8字节浮点数（double） - VT_CY：8字节定点数（货币值） - VT_BSTR：VB字符串 - VT_DECIMAL：12字节定点数（大数字） - VT_ERROR：标准错误编号 - VT_BOOL：布尔值 - VT_DATE：日期型 - VT_VARIANT：VB Variant类型 数组的下界（lLbound）可以是负数，而长度（cElements）决定了数组的元素数量。 ### 示例与应用 在实际开发中，SafeArray常用于以下场景： - 当VB应用程序需要与非VB组件（如VC++编写的DLL或OCX控件）交互时，SafeArray是数据交换的标准格式。 - 在Automation中，比如在VBA宏或脚本中调用OLE Automation对象，SafeArray用于传递数组参数。 - 自定义COM组件或ActiveX控件的开发，SafeArray可以帮助实现跨语言的数据交换。 SafeArray是COM环境中高效且安全的数据结构，用于在不同编程语言之间传递和操作数组数据。理解并熟练运用SafeArray的创建、访问和释放机制，对于进行跨语言的组件开发至关重要。