ScCountProps
Hace referencia a: Outlook 2013 | Outlook 2016
Determina el tamaño, en bytes, de una matriz de valores de propiedad y valida la memoria asociada a la matriz.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Llamado por: |
Aplicaciones cliente y proveedores de servicios |
SCODE ScCountProps(
int cprop,
LPSPropValue rgprop,
ULONG FAR * pcb
);
Parameters
cprop
[in] Recuento de propiedades de la matriz indicadas por el parámetro rgprop .
rgprop
[in] Puntero a un rango de una matriz de estructuras SPropValue que define las propiedades cuyo tamaño se va a determinar. Este intervalo no comienza necesariamente al principio de la matriz.
Pcb
[out] Puntero opcional al tamaño, en bytes, de la matriz de propiedades.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
MAPI_E_INVALID_PARAMETER
Al menos una propiedad de la matriz de valores de propiedad tiene un identificador de PROP_ID_NULL o PROP_ID_INVALID, o bien la matriz de propiedades contiene una propiedad multivalor sin valores de propiedad.
Comentarios
Si se pasa NULL en el parámetro pcb , la función ScCountProps valida la matriz de notificaciones, pero no se realiza el recuento. Si se pasa un valor no nulo en pcb, la función ScCountNotifications determina el tamaño de la matriz y almacena la causa pcb. El parámetro pcb debe ser lo suficientemente grande como para contener toda la matriz.
Mientras se cuenta, ScCountProps valida la memoria asociada a la matriz. ScCountProps solo funciona con propiedades sobre las que MAPI tiene información.