SafeArrayPutElement

指定された位置にデータ要素を格納する。

SafeArrayPutElement psa, rgIndices, pv

psa : [var] SafeArrayCreate で作成された配列ディスクリプタ。
rgIndices : [var] 配列の各次元のインデックスのベクタ。最も右の (最下位の) 次元が rgIndices[0] である。最も左の次元は rgIndices[psa->cDims ? 1] に格納される。
pv : [intptr] 配列に代入するデータ。variant 型 VT_DISPATCH、VT_UNKNOWN、VT_BSTR はポインタであり、もう 1 段階の間接参照を必要としない。

(プラグイン / モジュール : oleaut32.dll)

解説

指定された位置にデータ要素を格納する。

[戻り値]
この関数は次のいずれかの値を返すことがある。
（以下省略）

[備考]
この関数は要素を代入する前後に SafeArrayLock と SafeArrayUnlock
を自動的に呼び出す。データ要素が文字列、オブジェクト、または variant の場合、関数は safe array
が破棄される時にそれを正しくコピーする。既存の要素が文字列、オブジェクト、または variant の場合は正しくクリアされる。データ要素が
VT_DISPATCH または VT_UNKNOWN の場合、AddRef
が呼ばれてオブジェクトの参照カウントがインクリメントされる。注意:
配列には複数のロックを掛けることができる。配列が他の操作によってロックされている間も要素を配列に挿入できる。SafeArrayPutElement
の呼び出し例は、COM Fundamentals Lines サンプル (Lines.cpp の CLines::Add) を参照。

情報