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 |