IMessage::ModifyRecipients

9/8/2008

The ModifyRecipients método substitui a atual lista de destinatários por um novo.

Syntax

HRESULT ModifyRecipients (
  ULONG ulFlags,
  LPADRLIST lpMods
);

Parameters

• ulFlags
  [no] Máscara de bits de sinalizadores que controla as alterações do destinatário. MODRECIP_ADD Deve ser definido, indicando que os destinatários apontado pelo lpMods irá substituir a lista de destinatários existente; Todos os outros sinalizadores são ignorados.

• lpMods
  [no] Referência a um ADRLIST estrutura contendo uma lista de destinatários; não pode ser NULL.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

• S_OK
  Indica sucesso.

Remarks

ModifyRecipients Alterações lista Destinatários da mensagem de e ele é dessa lista, mantida em um ADRLIST estrutura, que a tabela de destinatário é compilado.

The ADRLIST estrutura contém um ADRENTRY estrutura para cada destinatário e cada ADRENTRY estrutura contém uma matriz de valores propriedade descrevendo as propriedades do destinatário.

Além resolvido e não resolvido destinatários, um destinatário pode ser NULL. Isto é, o cValues membro das ADRENTRY estrutura para o destinatário é definida como zero e o rgPropVals membro é definido como NULL.

Quando você especificar propriedades para um destinatário in a ADRLIST estrutura, incluir todas as propriedades do destinatário, não apenas as novas ou alteradas. Para recuperar o atual Conjunto de propriedades para todos os destinatários de uma mensagem, chamar IMessage::GetRecipientTable e recuperar todas as linhas. Porque um SRowSet é idêntica em estrutura para um ADRLIST, você pode usá-los de forma intercambiável.

A seguir estão algumas regras de configuração as propriedades de destinatários na ADRLIST estrutura:

• Não uso PT_NULL Como um tipo propriedade. ModifyRecipients Retorna um erro quando encontrar esse valor.
• Não uso PT_ERROR Como um tipo propriedade. ModifyRecipients Ignora este valor.
• Não inclua o PR_ROWID propriedade para qualquer um dos destinatários.

Se você incluir um a PR_ADDRTYPE propriedade ou PR_EMAIL_ADDRESS propriedade para um destinatário e uma ou ambas essas propriedades estão inconsistentes com o tipo endereço e endereço do destinatário conforme identificado pelo PR_ENTRYID, os resultados são indefinido. Isto é, se existirem três possibilidades, depending on provedor de serviço, da seguinte maneira:

• A mensagem é enviada para o endereço descrito pela PR_ADDRTYPE e MapVirtualKey. PR_EMAIL_ADDRESS Propriedades.
• A mensagem é entregue ao destinatário identificado por PR_ENTRYID.
• A mensagem é declarada devido a não entregues a ambigüidade das informações de endereço.

ModifyRecipients Não livre a ADRLIST estrutura ou qualquer um dos seus substructures. The ADRLIST estrutura e cada SPROPVALUE estrutura deve ser alocada separadamente usando o MAPIAllocateBuffer função, como se cada pode ser liberada individualmente. Se o método requer espaço adicional para qualquer SPROPVALUE estrutura, ele pode substituir o SPROPVALUE estrutura por um novo que posteriormente pode ser liberado usando MAPIFreeBuffer. O original SPROPVALUE estrutura também deve ser liberada usando MAPIFreeBuffer.

Requirements

Header	mapidefs.h
Library	cemapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMessage
ADRENTRY
ADRLIST
MAPIAllocateBuffer
MAPIFreeBuffer
SPropValue

Other Resources

Messaging