ScCopyProps
適用対象: Outlook 2013 | Outlook 2016
SPropValue 構造体の配列によって定義されたプロパティを新しい変換先にコピーします。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapiutil.h |
| 実装元: |
MAPI |
| 呼び出し元: |
クライアント アプリケーションとサービス プロバイダー |
SCODE ScCopyProps(
int cprop,
LPSPropValue rgprop,
LPVOID pvDst,
ULONG FAR * pcb
);
パラメーター
cprop
[in]コピーするプロパティの数。
rgprop
[in]コピーするプロパティを定義する SPropValue 構造体の配列へのポインター。 rgprop パラメーターは配列の先頭を指す必要はありませんが、配列内のいずれかの SPropValue 構造体の先頭を指す必要があります。
pvDst
[in]この関数がプロパティをコピーするメモリ内の初期位置へのポインター。
Pcb
[out] pvDst パラメーターが指すメモリ ブロックのサイズ (バイト単位) への省略可能なポインター。
戻り値
S_OK
プロパティが正常にコピーされました。
MAPI_E_INVALID_PARAMETER
不明なプロパティの種類が検出されました。
注釈
新しい配列とそのデータは、1 つの割り当てで作成されたバッファー内に存在し、 ScRelocProps 関数を使用して個々の SPropValue 構造体のポインターを調整できます。 この調整の前に、ポインターは有効です。
ScCopyProps は、 コピーされたプロパティ配列の元のプロパティ順序を保持します。
pcb パラメーターは省略可能です。NULL でない場合は、pvDst パラメーターに格納されているバイト数に設定されます。