IAddrBook::PrepareRecips
Hace referencia a: Outlook 2013 | Outlook 2016
Prepara una lista de destinatarios para su uso posterior por parte del sistema de mensajería.
HRESULT PrepareRecips(
ULONG ulFlags,
LPSPropTagArray lpSPropTagArray,
LPADRLIST lpRecipList
);
Parameters
ulFlags
[in] Máscara de bits de marcas que controla cómo se abre la entrada. Se puede establecer la marca siguiente:
MAPI_CACHE_ONLY
Use solo la libreta de direcciones sin conexión para realizar la resolución de nombres. Por ejemplo, puede usar esta marca para permitir que una aplicación cliente abra la lista global de direcciones (GAL) en modo de intercambio almacenado en caché y acceda a una entrada en esa libreta de direcciones desde la memoria caché sin crear tráfico entre el cliente y el servidor. Esta marca solo es compatible con el proveedor de libreta de direcciones de Exchange.
lpSPropTagArray
[in] Puntero a una estructura SPropTagArray que contiene una matriz de etiquetas de propiedad que indican las propiedades, si las hay, que requieren actualización. El parámetro lpSPropTagArray puede ser NULL.
lpRecipList
[in] Puntero a una estructura ADRLIST que contiene la lista de destinatarios.
Valor devuelto
S_OK
La lista de destinatarios se preparó correctamente.
Comentarios
Los clientes y proveedores de servicios llaman al método PrepareRecips para hacer lo siguiente:
Asegúrese de que todos los destinatarios del parámetro lpRecipList tienen identificadores de entrada a largo plazo.
Asegúrese de que cada destinatario del parámetro lpRecipList tiene las propiedades enumeradas en el parámetro lpSPropTagArray y de que estas propiedades aparecen al principio de la lista de destinatarios.
MAPI convierte los identificadores de entrada a corto plazo de cada destinatario en identificadores de entrada a largo plazo. Si es necesario, los identificadores de entrada a largo plazo de los destinatarios se recuperan del proveedor de libreta de direcciones adecuado y se solicitan propiedades adicionales.
En una entrada de destinatario individual, las propiedades solicitadas se ordenan primero, seguidas de las propiedades que ya estaban presentes para la entrada. Si el proveedor de libreta de direcciones adecuado no controla una o varias de las propiedades solicitadas en el parámetro lpSPropTagArray , sus tipos de propiedad se establecerán en PT_ERROR. Sus valores de propiedad se establecerán en para MAPI_E_NOT_FOUND o en otro valor que proporcione una razón más específica por la que las propiedades no están disponibles. Cada estructura SPropValue incluida en el parámetro lpRecipList debe asignarse por separado mediante las funciones MAPIAllocateBuffer y MAPIAllocateMore para que se pueda liberar individualmente.
Para obtener información sobre PT_ERROR, vea Tipos de propiedad.