COleCurrency::GetStatus

Artigo
02/25/2013

Chamar essa função de membro para obter o status (validade) de um determinado objeto de COleCurrency .

CurrencyStatus GetStatus( ) const;

Valor de retorno

Retorna o status de este valor de COleCurrency .

Comentários

O valor de retorno é definido pelo tipo enumerado de CurrencyStatus que é definido dentro da classe de COleCurrency .

enum CurrencyStatus{

valid = 0,

invalid = 1,

null = 2,

};

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

COleCurrency::valid indica que este objeto de COleCurrency é válido.
COleCurrency::invalid indica que este objeto de COleCurrency não é válido; isto é, o valor pode estar incorretos.
COleCurrency::null indica que este objeto de COleCurrency é 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 COleCurrency não é válido nos seguintes casos:

Se o valor é definido de um valor de VARIANT ou de COleVariant que não pode ser convertido em um valor de moeda.
Se este objeto apresentou um estouro ou um estouro negativo durante uma operação aritmética de atribuição, por exemplo += 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 as seguintes funções de membro:

Exemplo

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