ADRENTRY

Hace referencia a: Outlook 2013 | Outlook 2016

Describe cero o más propiedades que pertenecen a un destinatario.

Valor	Descripción
Archivo de encabezado:	Mapidefs.h

typedef struct _ADRENTRY
{
  ULONG ulReserved1;
  ULONG cValues;
  LPSPropValue rgPropVals;
} ADRENTRY, FAR *LPADRENTRY;

Members

ulReserved1

Reservados; debe ser cero.

cValues

Recuento de propiedades de la matriz de valores de propiedad a las que apunta el miembro rgPropVals . El miembro cValues puede ser cero.

rgPropVals

Puntero a una matriz de valores de propiedad que describe las propiedades del destinatario. El miembro rgPropVals puede ser NULL.

Comentarios

Una estructura ADRENTRY describe las propiedades que pertenecen a un único destinatario. Las propiedades que se usan normalmente para describir a un destinatario incluyen las siguientes:

PR_DISPLAY_NAME (PidTagDisplayName)

PR_ADDRTYPE (PidTagAddressType)

PR_EMAIL_ADDRESS (PidTagEmailAddress)

PR_ENTRYID (PidTagEntryId)

Cuando aparece un identificador de entrada o una propiedad PR_ENTRYID en la matriz SPropValue para un destinatario, esto indica que el destinatario se ha resuelto. Los clientes llaman al método IAddrBook::ResolveName para asegurarse de que se han resuelto todos los destinatarios de la lista de destinatarios de un mensaje saliente. Solo los destinatarios resueltos se pueden enviar con mensajes.

Las estructuras ADRENTRY se combinan normalmente para formar una matriz para el miembro aEntries de una estructura ADRLIST.

Las estructuras ADRENTRY y SRow son idénticas porque contienen un miembro reservado, una matriz de valores de propiedad y un recuento de valores en la matriz. Mientras que las estructuras ADRENTRY se combinan para formar el miembro aEntries de una estructura ADRLIST , las estructuras SRow se combinan para formar el miembro aRow de una estructura SRowSet . Ambos tipos de estructuras siguen las mismas reglas de asignación, lo que implica que una estructura SRowSet que se recupera de la tabla de contenido de un contenedor de libreta de direcciones se puede convertir a una estructura ADRLIST y usarse tal cual.

Una estructura ADRENTRY puede estar vacía. Por ejemplo, una estructura ADRENTRY contenida en la estructura ADRLIST a la que apunta el parámetro lppAdrList en una llamada a IAddrBook::Address puede estar vacía cuando se quita un destinatario.

Para obtener más información sobre cómo asignar memoria para estructuras ADRENTRY , vea Administrar memoria para estructuras ADRLIST y SRowSet.

Vea también

IAddrBook::Address
IMessage::ModifyRecipients
MAPIAllocateBuffer
ADRLIST
SRow
Estructuras MAPI de SRowSet