IRecipients::Add

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The Add method adds a person to the list of recipients for a Meeting Request. After you add the recipient, you must set the recipient's Address property. For more information, see IRecipient::put_Address.

Syntax

HRESULT Add(
   BSTR pwszName,
   IRecipient ** pRecipient
);

Parameters

• pwszName
  [in] Reference to a null-terminated Unicode string with the display name for the recipient. For information on the BSTR type, see BSTR.

• pRecipient
  [out] Reference to the new IRecipient object.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

• S_OK
  The method completed successfully.

Code Example

The following code example demonstrates how to create a Meeting Request, and then send it to three recipients.

void CreateMeetingRequest(IPOutlookApp * polApp)
{
    IRecurrencePattern * pRec;
    IAppointment       * pAppt;
    IRecipients        * pRecipients;
    IRecipient         * pRecipient;
    VAR_BOOL             bResolved;

    // Create an Appointment item.
    polApp->CreateItem(olAppointmentItem, (IDispatch**)&pAppt);

    // Set the subject.
    pAppt->put_Subject(TEXT("Recurring Appointment"));

    // Convert the date Thursday, May 10th, 2007, at 08:30 PM, to a Variant DATE object.
    SYSTEMTIME st;
    DATE date;

    memset(&st, 0, sizeof(SYSTEMTIME));

    st.wMonth = 5;
    st.wDay   = 10;
    st.wYear  = 2007;
    st.wHour  = 20.5;

    polApp->SystemTimeToVariantTime(&st, &date);

    // Set the start date.
    pAppt->put_Start(date);

    // Add recipients.
    pAppt->get_Recipients(&pRecipients);

    // Resolve the recipients against the list of Contacts stored in the data store on the device.
    IPOlRecipient * pRecip2;

    int iRecipientCount;

    pRecipients->get_Count(&iRecipientCount);

    // Count downward so that removing recipient does not reorder the remaining unresolved recipients.
    for (int i = iRecipientCount; i > 0; i--)
    {
        pRecipients->Item(i, &pRecipient)
        pRecipient->QueryInterface(IID_IPOlRecipient, (LPVOID*)&pRecip2);
        pRecip2->Resolve(TRUE, &bResolved);

        if (!bResolved)pRecipients->Remove(i);
            pRecip2->Release();
    }

    // Send the meeting request.
    pRecipients->get_Count(&iRecipientCount);

    if (iRecipientCount > 0)
        pAppt->Send();

    // Release resources.
    pRec->Release();
    pAppt->Release();

    pRecipients->Release();
    pRecipient->Release();
}

Requirements

See Also

Tasks

Creating a Meeting Request

Reference

IRecipient
IPOlRecipient
Pocket Outlook Object Model Interfaces

Other Resources