Partilhar via


COleDateTimeSpan::GetStatus

Obtém o status (validade) de esse objeto de COleDateTimeSpan .

DateTimeSpanStatus GetStatus( ) const throw( );

Valor de retorno

O status de este valor de COleDateTimeSpan .

Comentários

O valor de retorno é 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++.)

O status de um objeto de COleDateTimeSpan não é válido nos seguintes casos:

  • Se este objeto apresentou um estouro ou um estouro negativo durante uma operação aritmética de atribuição, como, += ou -=.

  • Se um valor inválido foi atribuído ao objeto.

  • Se o status de esse objeto for explicitamente a SetStatusem uso inválido.

Para obter mais informações sobre as operações que podem definir o status para inválido, consulte COleDateTimeSpan::operator +, - e COleDateTimeSpan::operator +=, - =.

Para obter mais informações sobre limites para valores de COleDateTimeSpan , consulte o artigo Data e hora: Suporte de automação.

Requisitos

Cabeçalho: atlcomtime.h

Consulte também

Referência

Classe de COleDateTimeSpan

Gráfico de hierarquia

COleDateTimeSpan::SetStatus

COleDateTimeSpan::m_status