COleCurrency::GetStatus

Articolo
02/19/2013

Chiamare la funzione membro per ottenere lo stato (validità) di un determinato oggetto COleCurrency.

CurrencyStatus GetStatus( ) const;

Valore restituito

Restituisce lo stato del valore COleCurrency.

Note

Il valore restituito è definito dal tipo enumerato CurrencyStatus definito nella classe COleCurrency.

enum CurrencyStatus{

valid = 0,

invalid = 1,

null = 2,

};

Per una breve descrizione di questi valori dello stato, vedere il seguente elenco:

COleCurrency::valid indica che l'oggetto COleCurrency è valido.
COleCurrency::invalid indica che l'oggetto COleCurrency non è valido; ovvero il valore può essere corretto.
COleCurrency::null indica che l'oggetto COleCurrency è null, ovvero, che nessun valore è stato fornito per l'oggetto.Ossia "null" nel senso del database di "non contiene alcun valore," rispetto a C++ NULL).

Lo stato di un oggetto COleCurrency non è valido nei seguenti casi:

Se il valore viene impostato da un valore COleVariant o VARIANT che non può essere convertito in un valore di valuta.
Se questo oggetto è verificato un overflow o un underflow durante l'operazione di assegnazione aritmetica, ad esempio += o *=.
Se un valore non valido è stato assegnato a tale oggetto.
Se lo stato di questo oggetto in modo esplicito è impostato su non valido utilizzando SetStatus.

Per ulteriori informazioni sulle operazioni che possono impostare lo stato su non valido, vedere le seguenti funzioni membro:

Esempio

// even an empty COleCurrency is valid
COleCurrency cy;
ASSERT(cy.GetStatus() == COleCurrency::valid);

// always valid after being set
cy.SetCurrency(4, 500);
ASSERT(cy.GetStatus() == COleCurrency::valid);

// some conversions aren't possible and will
// cause an invalid state, like this:
CByteArray array;
COleVariant varBogus(array);
cy = varBogus;
ASSERT(cy.GetStatus() == COleCurrency::invalid);