IRecurrencePattern::GetOccurrence

9/8/2008

The GetOccurrence método obtém a instância específica de um compromisso recorrente, ocorrendo em uma data específica. Altera para aplicar o compromisso para essa ocorrência específica somente. Se nenhuma exceção para um padrão recorrente existe, uma alteração cria uma nova exceção; caso contrário, ele modifica uma exceção existente.

Syntax

HRESULT GetOccurrence(
   DATE date,
   IAppointment ** ppolAppt
);

Parameters

• Data
  [no] Referência ao objeto de data que define o local de data e tempo do compromisso. Para informações sobre o Data tipo, consulte IPOutlookApp::VariantTimeToSystemTime. Para informações sobre o SYSTEMTIME estrutura, consulte SYSTEMTIME.

• ppolAppt
  [out] Referência de IAppointment recuperadas por esse método.

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 altera uma instância de um compromisso recorrente.

void ChangeRecurrence(IAppointment * pAppt)
{
    IPOutlookApp       * polApp;
    IRecurrencePattern * pRec;
    IAppointment       * pAppt2;

    SYSTEMTIME st = {0};
    DATE date;

    // Get the IPOutlookApp object and a Recurrence Pattern object.
    pAppt->get_Application(&polApp);
    pAppt->GetRecurrencePattern(&pRec);

    // Using the Recurrence Pattern object, get a specific instance of the recurring appointment.
    st.wMonth = 5;
    st.wDay   = 10;
    st.wYear  = 2007;

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

    pRec->GetOccurrence(date, &pAppt2);

    // Change the Appointment's Start Time, and generate an Appointment exception.
    st.wHour = 20.5;
    polApp->SystemTimeToVariantTime(&st, &date);
    pAppt2->put_Start(date);

    // Save the Appointment item.
    pAppt2->Save();

    // Release resources.
    polApp->Release();
    pRec->Release();
    pAppt2->Release();
}

Requirements

See Also

Tasks

Creating a Recurring Appointment

Reference

IRecurrencePattern
Pocket Outlook Object Model Interfaces