COleCurrency::GetStatus

Article
06/10/2015

Appelez la fonction membre pour obtenir l'état (validité) d'un objet donné de COleCurrency .

CurrencyStatus GetStatus( ) const;

Valeur de retour

Retourne l'état de cette valeur de COleCurrency .

Notes

La valeur de retour est définie par le type énuméré par CurrencyStatus défini dans la classe de COleCurrency .

enum CurrencyStatus{

valid = 0,

invalid = 1,

null = 2,

};

Pour obtenir une brève description de ces valeurs d'état, consultez la liste suivante :

COleCurrency::valid indique que cet objet de COleCurrency est valide.
COleCurrency::invalid indique que cet objet de COleCurrency n'est pas valide ; autrement dit, sa valeur peut être incorrecte.
COleCurrency::null indique que cet objet de COleCurrency est null, c. autrement dit., qu'aucune valeur n'a été fournie pour cet objet. (C'est null dans l'ordre de base de données « avoir aucune valeur », par opposition à C++ NULL.)

L'état d'un objet de COleCurrency n'est pas valide dans les cas suivants :

Si sa valeur est définie d'une valeur de variant ou d' COleVariant qui ne peut pas être convertie en une valeur monétaire.
Si cet objet a rencontré un dépassement de capacité ou un dépassement de capacité pendant une opération arithmétique de devoir, par exemple += ou *=.
Si une valeur non valide a été assignée à cet objet.
Si l'état de cet objet a été explicitement la valeur non valide à l'aide de SetStatus.

Pour plus d'informations sur les opérations qui peuvent affecter le mode à incorrect, consultez les fonctions membres suivantes :

Exemple

// 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);