通过

PropCopyMore

  • 项目

适用于：Outlook 2013 | Outlook 2016

将单个属性值从源位置复制到目标位置。

属性 值
标头文件：
 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 函数从即将释放的表中复制属性，以便在其他位置使用它。

PropCopyMore 不需要分配内存，除非复制的属性值的类型（如 PT_STRING8）不适合 SPropValue 结构。 对于这些大型属性，该函数使用 MAPIAllocateMore 函数分配内存，该函数在 lpfAllocMore 参数中向其传递指针。

不当使用 PropCopy 更多 片段内存;请考虑改用 ScCopyProps 函数。