IRecipients::Add

9/8/2008

The Adicionar método adiciona uma pessoa para a lista de destinatários para um Meeting Request. Após adicionar o destinatário, você deve definir propriedade de endereço do destinatário. For more information, see IRecipient::put_Address.

Syntax

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

Parameters

• pwszName
  [no] Referência a um seqüência de caracteres Unicode NULL-Terminated com o nome para o destinatário exibir. Para informações sobre o BSTR tipo, consulte BSTR.

• pRecipient
  [out] Referência ao novo objeto IRecipient.

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
  The method completed successfully.

Exemplo de código

O seguinte exemplo de código demonstra como criar uma solicitação de reunião e, em seguida, enviá-lo para três destinatários.

Observação

Para tornar o exemplo de código mais fácil para ler, verificação de segurança e manipulação de erro não estão incluídos.This code example should not be used in a release configuration unless it has been modified to include them.

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

Header	pimstore.h
Library	Pimstore.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Tasks

Creating a Meeting Request

Reference

IRecipient
IPOlRecipient
Pocket Outlook Object Model Interfaces

Other Resources