ScCountProps

适用于:Outlook 2013 | Outlook 2016

确定属性值数组的大小(以字节为单位),并验证与该数组关联的内存。

属性
标头文件:
Mapiutil.h
实现者:
MAPI
调用者:
客户端应用程序和服务提供商
SCODE ScCountProps(
  int cprop,
  LPSPropValue rgprop,
  ULONG FAR * pcb
);

参数

cprop

[in] 由 rgprop 参数指示的数组中的属性计数。

rgprop

[in]指向 SPropValue 结构数组中的区域的指针,该结构定义要确定其大小的属性。 此范围不一定从数组的开头开始。

Pcb

[out]指向属性数组的大小(以字节为单位)的可选指针。

返回值

S_OK

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

MAPI_E_INVALID_PARAMETER

属性值数组中至少有一个属性具有PROP_ID_NULL或PROP_ID_INVALID标识符,或者属性数组包含没有属性值的多值属性。

备注

如果在 印刷电路板 参数中传递 NULL, 则 ScCountProps 函数将验证通知数组,但不执行计数。 如果一个非 null 值在印刷品中传递,则 ScCountNotifications 函数将确定数组的大小并存储原因 印刷机参数必须足够大,才能包含整个数组。

在计数时, ScCountProps 会验证与数组关联的内存。 ScCountProps 仅适用于 MAPI 具有信息的属性。

另请参阅

PropCopyMore