COleSafeArray::PutElement

void PutElement( long* rgIndices, LPVOID pvData );

参数:
rgIndices指向一个数组的指针。该数组包含安全数组的每一个元素的索引。
pvData指向要赋给数组的数据的指针。VT_DISPATCH,VT_UNKNOWN,和VT_BSTR 可变类型都是指针,它们不需要其它级别的迂回。

说明:
这个函数用来将一个单一的元素赋给数组。在分配元素之前和分配元素之后,此函数自动调用Windows函数SafeArrayLock和SafeArrayUnlock。如果数据元素是一个字符串,对象或可变类型,则函数会正确拷贝它们,并且如果已经存在的元素是一个字符串,对象,或可变类型,它们将被清除。
注意你可以对一个数组进行多重锁定,这样当数组被其它操作加锁时,你仍然可以将元素放入这个数组中。
如果出错,函数将抛出一个CMemoryException或COleException。

请参阅:
COleSafeArray::GetElement, SafeArrayPutElement