PropCopyMore

Область применения: Outlook 2013 | Outlook 2016

Копирует одно значение свойства из исходного расположения в целевое расположение.

Свойство	Значение
Файл заголовка:	Mapiutil.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения и поставщики услуг

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

Параметры

lpSPropValueDest

[out] Указатель на расположение, в которое эта функция записывает структуру SPropValue , определяющую скопированное значение свойства.

lpSPropValueSrc

[в] Указатель на структуру SPropValue , содержащую копируемые значения свойства.

lpfAllocMore

[в] Указатель на функцию MAPIAllocateMore , которая будет использоваться для выделения дополнительной памяти, если целевое расположение недостаточно для хранения свойства для копирования.

lpvObject

[в] Указатель на объект, для которого MAPIAllocateMore при необходимости выделяет место.

Возвращаемое значение

S_OK

Одно значение свойства было успешно скопировано.

MAPI_E_NO_SUPPORT

Обнаружен неизвестный тип свойства.

Замечания

Клиентское приложение или поставщик услуг может использовать функцию PropCopyMore для копирования свойства из таблицы, которая будет освобождена, чтобы использовать его в другом месте.

PropCopyMore не требует выделения памяти, если скопированное значение свойства не относится к типу, например PT_STRING8, который не помещается в структуру SPropValue . Для этих больших свойств функция выделяет память с помощью функции MAPIAllocateMore , в которую передается указатель в параметре lpfAllocMore .

Неправосудное использование памяти фрагментов PropCopyMore ; Вместо этого рекомендуется использовать функцию ScCopyProps .