VARIANT的使用方法

最新推荐文章于 2025-05-17 18:57:29 发布

xinzhiyounizhiyouni

最新推荐文章于 2025-05-17 18:57:29 发布

阅读量1w

点赞数 3

CC 4.0 BY-SA版权

文章标签： VARIANT

本文链接：https://blog.youkuaiyun.com/xinzhiyounizhiyouni/article/details/20127975

本文深入探讨了VARIANT结构体的内部构造及其在COM中的应用。详细解释了如何通过VARIANT来传递各种类型的数据，并提供了具体的使用案例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

VARIANT结构体主要是使用在COM（组件对象模型）中用于传递参数使用，它的存在主要是为了保持一个在COM参数传递方法的统一性，它几乎包含了所有普通常用类型的数据类型的传递，如整型，浮点型，布尔型等等，以及相应类型的指针类型，如整型指针。它的使用也比较方便。先来看看这个结构体它的结构：

typedef struct tagVARIANT {
union {
struct __tagVARIANT {
VARTYPE vt;
WORD wReserved1;
WORD wReserved2;
WORD wReserved3;
union {
LONGLONG llVal;
LONG lVal;
BYTE bVal;
SHORT iVal;
FLOAT fltVal;
DOUBLE dblVal;
VARIANT_BOOL boolVal;
_VARIANT_BOOL bool;
SCODE scode;
CY cyVal;
DATE date;
BSTR bstrVal;
IUnknown *punkVal;
IDispatch *pdispVal;
SAFEARRAY *parray;
BYTE *pbVal;
SHORT *piVal;
LONG *plVal;
LONGLONG *pllVal;
FLOAT *pfltVal;
DOUBLE *pdblVal;
VARIANT_BOOL *pboolVal;
_VARIANT_BOOL *pbool;
SCODE *pscode;
CY *pcyVal;
DATE *pdate;
BSTR *pbstrVal;
IUnknown **ppunkVal;
IDispatch **ppdispVal;
SAFEARRAY **pparray;
VARIANT *pvarVal;
PVOID byref;
CHAR cVal;
USHORT uiVal;
ULONG ulVal;
ULONGLONG ullVal;
INT intVal;
UINT uintVal;
DECIMAL *pdecVal;
CHAR *pcVal;
USHORT *puiVal;
ULONG *pulVal;
ULONGLONG *pullVal;
INT *pintVal;
UINT *puintVal;
struct __tagBRECORD {
PVOID pvRecord;
IRecordInfo *pRecInfo;
} __VARIANT_NAME_4;
} __VARIANT_NAME_3;
} __VARIANT_NAME_2;
DECIMAL decVal;
} __VARIANT_NAME_1;
} VARIANT, *LPVARIANT, VARIANTARG, *LPVARIANTARG;

这个结构体呢，有5个成员，分别是VARTYPE vt ,WORD wReserved1,WORD wReserved2,WORD wReserved3,和最后一个共用体。其中vt用以指明最后一个共用体中哪一个成员有效,wReserved1,wReserved2,wReserved3,这三个我们使用的时候不用管，系统保留，最后一个共用体根据vt的提示，对相应的成员进行值的存储。我们从两个不同的角度来理解，首先是使用VARIANT来存储参数，首先是声明一个这个结构体的对象，然后对对象的vt进行赋值，它可接受的值是一个枚举值，也就说只能在枚举这个范围内取值，比如我要用VARIANT传递一个整数，现在我对vt的赋值为VT_INT，这样就说明了我要使用这个结构体中共用体的整型变量，接着对INT变量进行赋值，赋我们要传递的值。这样就完成VARIANT的传递。现在我们从另外一个角度来理解VARIANT，刚才是我们对VARIANT对象进行赋值传递，现在我们是这个VARIANT对象的接收者，我们从参数中获得这个对象之后，我们首先检查这个结构体的vt成员，看它哪个类型的变量有效，比如就这个例子而言，检查到vt的值是VT_INT，因此，我直接去获取这个结构体中VT_INT所对应的变量，获取它的值。这样，我们从传递到使用两个角度来理解了VARIANT结构体，概括起来说，就是vt指明了我要传递的变量的类型，结构体中共用体的成员用来存储vt指明的类型的值。

下面来看看具体VARIANT结构体是如何使用赋值的，首先是第一种方法：

首先我们声明一个VARIANT结构体的对象vr1，然后使用VariantInit函数对其进行初始化，它的作用就是对vt赋VT_EMPTY，对别的变量值附空，否则就是一个随机值，这个过程和我们声明一个int变量一样，如果声明的时候不初始化，就是一个随机值。编程过程中，不管是指针还是什么变量，都应该在声明之后对其进行初始化。接着就是我赋VT_INT给vt，这里的V_VT就是代表要对vr1结构体中的vt成员进行幅值，接着对vr1中的INT成员赋值，这里的V_INT就是表示要对INT赋值，因此这里有一个规律，就是V_，它的后面加成员类型就可以对相应的成员赋值，而这里的成员类型有一个对照表，在文章的最后给出，比如，我要对BSTR成员赋值，我就用V_BSTR。这时候，就可以使用vr1了，使用完成之后，我们应该调用VariantClear函数，这个函数的作用就是将vt赋值为VT_EMPTY，以及释放使用这个结构体中的内存中的内容，如果是com对象，该函数是不会进行对象的release操作的，不管怎么样，我们都应该在使用完了VARIANT结构体之后，调用这个函数。

下面是第二种方法，原理和过程和地中方法类似，有一点微小的区别，就是VARIANT结构体的赋值上面来说，有点不同，如下：

接下来是字符串的操作，BSTR，我们不能直接将字符串传递一个VARIANT结构体对象，而是要用到函数SysAllocString，它的返回值就是一个BSTR，由它分配一个字符串，供VARIANT，对于为什么要这么做，可以自己查看MSDN COM的Automation那部分：

完成之后，我们还应该调用SysFreeString来释放由SysAllocString分配的内存。

另外，我们可以在类型与变量的对照表中发现，同一类型，对应了两种不同的变量，如，INT对应了变量有intVal和pintVal，其实这很简单，后者是指针性，如果要使用，说明我们赋值的对象是一个指针，如下：

最后给出类型与变量的对照表，如果是使用地中方法用V_加类型，就直接使用下表中VT_后的名称就可以了：

Member name	Description
	VT_EMPTY	Indicates that a value was not specified.
	VT_NULL	Indicates a null value, similar to a null value in SQL.
	VT_I2	Indicates a short integer.
	VT_I4	Indicates a long integer.
	VT_R4	Indicates a float value.
	VT_R8	Indicates a double value.
	VT_CY	Indicates a currency value.
	VT_DATE	Indicates a DATE value.
	VT_BSTR	Indicates a BSTR string.
	VT_DISPATCH	Indicates an IDispatch pointer.
	VT_ERROR	Indicates an SCODE.
	VT_BOOL	Indicates a Boolean value.
	VT_VARIANT	Indicates a VARIANT far pointer.
	VT_UNKNOWN	Indicates an IUnknown pointer.
	VT_DECIMAL	Indicates a decimal value.
	VT_I1	Indicates a char value.
	VT_UI1	Indicates a byte.
	VT_UI2	Indicates an unsignedshort.
	VT_UI4	Indicates an unsignedlong.
	VT_I8	Indicates a 64-bit integer.
	VT_UI8	Indicates an 64-bit unsigned integer.
	VT_INT	Indicates an integer value.
	VT_UINT	Indicates an unsigned integer value.
	VT_VOID	Indicates a C style void.
	VT_HRESULT	Indicates an HRESULT.
	VT_PTR	Indicates a pointer type.
	VT_SAFEARRAY	Indicates a SAFEARRAY. Not valid in a VARIANT.
	VT_CARRAY	Indicates a C style array.
	VT_USERDEFINED	Indicates a user defined type.
	VT_LPSTR	Indicates a null-terminated string.
	VT_LPWSTR	Indicates a wide string terminated by nullNothingnullptra null reference (Nothing in Visual Basic).
	VT_RECORD	Indicates a user defined type.
	VT_FILETIME	Indicates a FILETIME value.
	VT_BLOB	Indicates length prefixed bytes.
	VT_STREAM	Indicates that the name of a stream follows.
	VT_STORAGE	Indicates that the name of a storage follows.
	VT_STREAMED_OBJECT	Indicates that a stream contains an object.
	VT_STORED_OBJECT	Indicates that a storage contains an object.
	VT_BLOB_OBJECT	Indicates that a blob contains an object.
	VT_CF	Indicates the clipboard format.
	VT_CLSID	Indicates a class ID.
	VT_VECTOR	Indicates a simple, counted array.
	VT_ARRAY	Indicates a SAFEARRAY pointer.
	VT_BYREF	Indicates that a value is a reference.