释义 |
COleSafeArray::PutElement
void PutElement( long* rgIndices, LPVOID pvData );
参数:rgIndices | 指向一个数组的指针。该数组包含安全数组的每一个元素的索引。 | pvData | 指向要赋给数组的数据的指针。VT_DISPATCH,VT_UNKNOWN,和VT_BSTR 可变类型都是指针,它们不需要其它级别的迂回。 |
说明: 这个函数用来将一个单一的元素赋给数组。在分配元素之前和分配元素之后,此函数自动调用Windows函数SafeArrayLock和SafeArrayUnlock。如果数据元素是一个字符串,对象或可变类型,则函数会正确拷贝它们,并且如果已经存在的元素是一个字符串,对象,或可变类型,它们将被清除。 注意你可以对一个数组进行多重锁定,这样当数组被其它操作加锁时,你仍然可以将元素放入这个数组中。 如果出错,函数将抛出一个CMemoryException或COleException。
请参阅: COleSafeArray::GetElement, SafeArrayPutElement |