CreateIProp

适用于：Outlook 2013 | Outlook 2016

创建属性数据对象，即 IPropData 对象。

属性	值
标头文件：	Mapiutil.h
实现者：	MAPI
调用者：	客户端应用程序和服务提供商

SCODE CreateIProp(
  LPCIID lpInterface,
  ALLOCATEBUFFER FAR * lpAllocateBuffer,
  ALLOCATEMORE FAR * lpAllocateMore,
  FREEBUFFER FAR * lpFreeBuffer,
  LPVOID lpvReserved,
  LPPROPDATA FAR * lppPropData
);

参数

lpInterface

[in]指向属性数据对象的接口标识符 (IID) 的指针。 IID_IMAPIPropData有效的接口标识符。 在 lpInterface 参数中传递 NULL 还会导致 lppPropData 参数中返回的属性数据对象强制转换为属性数据对象的标准接口。

lpAllocateBuffer

[in]指向 MAPIAllocateBuffer 函数的指针，用于分配内存。

lpAllocateMore

[in]指向 MAPIAllocateMore 函数的指针，用于分配额外的内存。

lpFreeBuffer

[in]指向 MAPIFreeBuffer 函数的指针，用于释放内存。

lpvReserved

[in]保留;必须为零。

lppPropData

[out]指向返回的属性数据对象的指针的指针。

返回值

S_OK

调用成功，并返回了预期的值。

MAPI_E_INTERFACE_NOT_SUPPORTED

此对象不支持请求的接口。

备注

lpAllocateBuffer、lpAllocateMore 和 lpFreeBuffer 输入参数分别指向 MAPIAllocateBuffer、MAPIAllocateMore 和 MAPIFreeBuffer 函数。 调用 CreateIProp 的 客户端应用程序将指针传入刚命名的 MAPI 函数;服务提供程序将指针传递给在初始化调用中接收的这些函数，或者通过调用 IMAPISupport：：GetMemAllocRoutines 方法检索的这些函数。