COleDateTimeSpan::GetStatus
Gets the status (validity) of this COleDateTimeSpan object.
DateTimeSpanStatus GetStatus( ) const throw( );
Return Value
The status of this COleDateTimeSpan value.
Remarks
The return value is defined by the DateTimeSpanStatus enumerated type, which is defined within the COleDateTimeSpan class.
enum DateTimeSpanStatus{
valid = 0,
invalid = 1,
null = 2,
};
For a brief description of these status values, see the following list:
COleDateTimeSpan::valid Indicates that this COleDateTimeSpan object is valid.
COleDateTimeSpan::invalid Indicates that this COleDateTimeSpan object is invalid; that is, its value may be incorrect.
COleDateTimeSpan::null Indicates that this COleDateTimeSpan object is null, that is, that no value has been supplied for this object. (This is "null" in the database sense of "having no value," as opposed to the C++ NULL.)
The status of a COleDateTimeSpan object is invalid in the following cases:
If this object has experienced an overflow or underflow during an arithmetic assignment operation, namely, += or -=.
If an invalid value was assigned to this object.
If the status of this object was explicitly set to invalid using SetStatus.
For more information about the operations that may set the status to invalid, see COleDateTimeSpan::operator +, - and COleDateTimeSpan::operator +=, -=.
For more information about the bounds for COleDateTimeSpan values, see the article Date and Time: Automation Support.
Requirements
Header: atlcomtime.h