CComSafeArray::Add
1 つ以上の要素または 1 つの SAFEARRAY 構造体を CComSafeArray に追加します。
HRESULT Add(
const SAFEARRAY * psaSrc
);
HRESULT Add(
ULONG ulCount,
const T * pT,
BOOL bCopy = TRUE
);
HRESULT Add(
const T& t,
BOOL bCopy = TRUE
);
パラメーター
psaSrc
SAFEARRAY オブジェクトへのポインター。ulCount
配列に追加するオブジェクトの数。pT
配列に追加する 1 つ以上のオブジェクトへのポインター。t
配列に追加するオブジェクトへの参照。bCopy
データのコピーを作成するかどうかを指定する値。既定値は TRUE です。
戻り値
正常に終了した場合は、S_OK を返します。それ以外の場合は、エラーの HRESULT を返します。
解説
新規オブジェクトが、既存の SAFEARRAY オブジェクトの末尾に追加されます。多次元 SAFEARRAY オブジェクトへのオブジェクトの追加はサポートされていません。既存のオブジェクトの配列を追加する場合は、両方の配列に含まれる要素が同じ型である必要があります。
BSTR 型または VARIANT 型の要素を配列に追加する場合は、bCopy フラグが選択されます。既定値 TRUE では、要素が配列に追加されるとデータのコピーが新たに作成されます。
必要条件
ヘッダー : atlsafe.h