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