Compartilhar via


Função VariantToDoubleWithDefault (propvarutil.h)

Extrai um valor DOUBLE de uma estrutura VARIANT . Se nenhum valor existir, o valor padrão especificado será retornado.

Sintaxe

PSSTDAPI_(DOUBLE) VariantToDoubleWithDefault(
  [in] REFVARIANT varIn,
  [in] DOUBLE     dblDefault
);

Parâmetros

[in] varIn

Tipo: REFVARIANT

Referência a uma estrutura VARIANT de origem.

[in] dblDefault

Tipo: DOUBLE

O valor padrão para uso em que nenhum valor extraível existe.

Retornar valor

Tipo: DOUBLE

Retorna o valor duplo extraído; caso contrário, o valor padrão especificado em dblDefault.

Comentários

Essa função auxiliar é usada quando o aplicativo de chamada espera que um VARIANT mantenha um valor DOUBLE e deseja usar um valor padrão se não o fizer.

Se a VARIANT de origem for do tipo VT_R8, esse auxiliar extrairá o valor DOUBLE .

Se a VARIANT de origem não for do tipo VT_R8, a função tentará converter o valor em VARIANT em um DOUBLE.

Se a VARIANT de origem for do tipo VT_EMPTY ou uma conversão não for possível, VariantToDoubleWithDefault retornará o valor padrão fornecido por dblDefault. Consulte PropVariantChangeType para obter uma lista de conversões possíveis.

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar VariantToDoubleWithDefault para acessar um valor DOUBLE armazenado em uma estrutura VARIANT .

// VARIANT var;
// Assume variable var is initialized and valid.
// The application expects var to hold a DOUBLE value.

// The application wants to treat VT_EMPTY as 3.1415.
DOUBLE dblValue = VariantToDoubleWithDefault(var, 3.1415);

// dblValue is now valid.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho propvarutil.h
Biblioteca Propsys.lib
DLL Propsys.dll (versão 6.0 ou posterior)
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0

Confira também

InitVariantFromDouble

PropVariantChangeType

PropVariantToDouble

VariantToDouble