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 具有信息的属性。