ScCopyProps
Область применения: Outlook 2013 | Outlook 2016
Копирует свойства, определенные массивом структур SPropValue, в новое назначение.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapiutil.h |
| Реализовано в: |
MAPI |
| Вызывающая сторона: |
Клиентские приложения и поставщики услуг |
SCODE ScCopyProps(
int cprop,
LPSPropValue rgprop,
LPVOID pvDst,
ULONG FAR * pcb
);
Параметры
cprop
[в] Количество копируемых свойств.
rgprop
[в] Указатель на массив структур SPropValue , определяющих копируемые свойства. Параметр rgprop не должен указывать на начало массива, но он должен указывать на начало одной из структур SPropValue в массиве.
pvDst
[в] Указатель на начальную позицию в памяти, в которую эта функция копирует свойства.
Pcb
[out] Необязательный указатель на размер (в байтах) блока памяти, на который указывает параметр pvDst .
Возвращаемое значение
S_OK
Свойства успешно скопированы.
MAPI_E_INVALID_PARAMETER
Обнаружен неизвестный тип свойства.
Замечания
Новый массив и его данные находятся в буфере, созданном с одним выделением, и функцию ScRelocProps можно использовать для настройки указателей в отдельных структурах SPropValue . До этой корректировки указатели действительны.
ScCopyProps поддерживает исходный порядок свойств для скопированного массива свойств.
Параметр pcb необязателен; Если значение не равно NULL, задается количество байтов, хранящихся в параметре pvDst .