COleDateTimeSpan::SetStatus

Artigo
02/25/2013

Define o status (validade) de esse objeto de COleDateTimeSpan.

void SetStatus(
   DateTimeSpanStatus status 
) throw( );

Parâmetros

status
O novo valor de status para este objeto de COleDateTimeSpan .

Comentários

O valor do parâmetro de status é definido pelo tipo enumerado de DateTimeSpanStatus , que é definido dentro da classe de COleDateTimeSpan .

enum DateTimeSpanStatus{

valid = 0,

invalid = 1,

null = 2,

};

Para obter uma descrição resumida de esses valores de status, consulte a lista a seguir:

COleDateTimeSpan::valid indica que este objeto de COleDateTimeSpan é válido.
COleDateTimeSpan::invalid indica que este objeto de COleDateTimeSpan não é válido; isto é, o valor pode estar incorretos.

COleDateTimeSpan::null indica que este objeto de COleDateTimeSpan é zero, isto é, que nenhum valor foi fornecido para esse objeto.(Esse é “zero” no sentido de banco de dados de “não ter nenhum valor”, diferentemente de NULOC++.)

Cuidado
Essa função é para situações avançados de programação.Essa função não altera os dados em esse objeto.Será usada com mais freqüência para definir o status para null ou a invalid.Observe que o operador de atribuição (operador =) e SetDateTimeSpan define o status de objeto com base nos valores de origem.

Exemplo

// if the person is not still in school, set days to graduation to null
if (!m_bStillInSchool || m_dtDateOfGraduation.GetStatus() == COleDateTime::null)
   m_dtsDaysToGraduation.SetStatus(COleDateTimeSpan::null);