Compartilhar via

ADRENTRY

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Descreve zero ou mais propriedades que pertencem a um destinatário.

Valor Descrição
Arquivo de cabeçalho:
 Mapidefs.h
 
typedef struct _ADRENTRY
{
  ULONG ulReserved1;
  ULONG cValues;
  LPSPropValue rgPropVals;
} ADRENTRY, FAR *LPADRENTRY;

Members

ulReserved1

Reservados; deve ser zero.

cValues

Contagem de propriedades na matriz de valor da propriedade apontada pelo membro rgPropVals . O membro cValues pode ser zero.

rgPropVals

Ponteiro para uma matriz de valor de propriedade que descreve as propriedades do destinatário. O membro rgPropVals pode ser NULL.

Comentários

Uma estrutura ADRENTRY descreve propriedades que pertencem a um único destinatário. As propriedades que normalmente são usadas para descrever um destinatário incluem o seguinte:

PR_DISPLAY_NAME (PidTagDisplayName)

PR_ADDRTYPE (PidTagAddressType)

PR_EMAIL_ADDRESS (PidTagEmailAddress)

PR_ENTRYID (PidTagEntryId)

Quando um identificador de entrada ou PR_ENTRYID propriedade aparece na matriz SPropValue para um destinatário, isso indica que o destinatário foi resolvido. Os clientes chamam o método IAddrBook::ResolveName para garantir que todos os destinatários na lista de destinatários de uma mensagem de saída tenham sido resolvidos. Somente destinatários resolvidos podem ser enviados com mensagens.

As estruturas ADRENTRY normalmente são combinadas para formar uma matriz para o membro aEntries de uma estrutura ADRLIST.

As estruturas do ADRENTRY e as estruturas SRow são idênticas porque contêm um membro reservado, uma matriz de valores de propriedade e uma contagem de valores na matriz. Enquanto as estruturas do ADRENTRY são combinadas para formar o membro aEntries de uma estrutura ADRLIST , as estruturas SRow são combinadas para formar o membro aRow de uma estrutura SRowSet . Ambos os tipos de estruturas seguem as mesmas regras de alocação, implicando que uma estrutura SRowSet recuperada da tabela de conteúdo de um contêiner de catálogo de endereços pode ser lançada para uma estrutura ADRLIST e usada como está.

Uma estrutura ADRENTRY pode estar vazia. Por exemplo, uma estrutura ADRENTRY contida na estrutura ADRLIST apontada pelo parâmetro lppAdrList em uma chamada para IAddrBook::Address pode estar vazia quando um destinatário está sendo removido.

Para obter mais informações sobre como alocar memória para estruturas ADRENTRY , consulte Gerenciando memória para estruturas ADRLIST e SRowSet.

Confira também

IAddrBook::Address
IMessage::ModifyRecipients
MAPIAllocateBuffer
ADRLIST
SRow
Estruturas MAPIdo SRowSet