Unicode C

Clear the To Recipients of an Email

Demonstrates the Chilkat Email.ClearTo method, which clears the list of direct (To) recipients. It changes only the current in-memory email object and does not affect messages already sent. This example adds two To recipients, clears them, and prints the count before and after.

Background: The To list holds a message's primary recipients. When reusing one Email object as a template across multiple sends, ClearTo wipes just that list so each send addresses the right people, without disturbing the subject, body, or attachments. It pairs with ClearCC and ClearBcc for full control over the recipient lists.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;

    //  Demonstrates the ClearTo method, which clears the list of direct (To) recipients.
    //  This changes only the current email object.

    email = CkEmailW_Create();

    CkEmailW_AddTo(email,L"Joe",L"joe@example.com");
    CkEmailW_AddTo(email,L"Jane",L"jane@example.com");
    wprintf(L"NumTo before clear = %d\n",CkEmailW_getNumTo(email));

    //  Remove all To recipients.
    CkEmailW_ClearTo(email);

    wprintf(L"NumTo after clear = %d\n",CkEmailW_getNumTo(email));


    CkEmailW_Dispose(email);

    }