ScCopyNotifications

Hace referencia a: Outlook 2013 | Outlook 2016

Copia un grupo de notificaciones de eventos en un único bloque de memoria.

Propiedad	Valor
Archivo de encabezado:	Mapiutil.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

SCODE ScCopyNotifications(
  int cntf,
  LPNOTIFICATION rgntf,
  LPVOID pvDst,
  ULONG FAR * pcb
);

Parameters

cntf

[in] Recuento de estructuras NOTIFICATION en la matriz indicada por el parámetro rgntf .

rgntf

[in] Puntero a una matriz de estructuras NOTIFICATION que definen las notificaciones de eventos que se van a copiar.

pvDst

[out] Puntero a las notificaciones devueltas.

Pcb

[out] Puntero opcional a una variable donde se almacena el tamaño, en bytes, de la matriz a la que apunta el parámetro rgntf . Si no es NULL, el parámetro pcb se establece en el número de bytes almacenados en el parámetro pvDst .

Valor devuelto

S_OK

Las notificaciones de eventos se copiaron correctamente.

E_INVALIDARG

Se encontró una notificación no válida.

Comentarios

Si se pasa NULL en el parámetro pcb , no se realiza ninguna copia; Si se pasa un valor distinto de NULL en pcb, la función ScCopyNotifications copia el tamaño de la matriz y la propia matriz en un único bloque de memoria. Si pcb no es NULL, se establece en el número de bytes almacenados en el parámetro pvDst . El parámetro pvDst debe ser lo suficientemente grande como para contener toda la matriz.