PropCopyMore

適用対象: Outlook 2013 | Outlook 2016

ソースの場所からコピー先の場所に 1 つのプロパティ値をコピーします。

プロパティ	値
ヘッダー ファイル:	Mapiutil.h
実装元:	MAPI
呼び出し元:	クライアント アプリケーションとサービス プロバイダー

SCODE PropCopyMore(
  LPSPropValue lpSPropValueDest,
  LPSPropValue lpSPropValueSrc,
  ALLOCATEMORE * lpfAllocMore,
  LPVOID lpvObject
);

パラメーター

lpSPropValueDest

[out]コピーされたプロパティ値を定義する SPropValue 構造体をこの関数が書き込む場所へのポインター。

lpSPropValueSrc

[in]コピーするプロパティ値を含む SPropValue 構造体へのポインター。

lpfAllocもっと

[in]コピー先の場所がコピーするプロパティを保持するのに十分な大きさでない場合に追加のメモリを割り当てるために使用する MAPIAllocateMore 関数へのポインター。

lpvObject

[in] MAPIAllocateMore が必要に応じて領域を割り当てるオブジェクトへのポインター。

戻り値

S_OK

単一のプロパティ値が正常にコピーされました。

MAPI_E_NO_SUPPORT

不明なプロパティの種類が検出されました。

注釈

クライアント アプリケーションまたはサービス プロバイダーは 、PropCopyMore 関数を使用して、他の場所でプロパティを使用するために解放されるテーブルからプロパティをコピーできます。

コピーされたプロパティ値が SPropValue 構造体に収まらない型 (PT_STRING8 など) でない限り、PropCopyMore はメモリを割り当てる必要はありません。 これらの大きなプロパティの場合、関数は、ポインターが lpfAllocMore パラメーターで渡される MAPIAllocateMore 関数を使用してメモリを割り当てます。

PropCopyの不正な使用さらにメモリをフラグメント化します。代わりに ScCopyProps 関数を使用することを検討してください。