Compartilhar via


VarParseNumFromStr

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Esta função analisa um seqüência de caracteres e cria um tipo-independente de descrição do número que representa.

Syntax

HRESULT VarParseNumFromStr( 
  OLECHAR* strIn, 
  LCID lcid, 
  unsigned long dwFlags, 
  NUMPARSE* pnumprs, 
  unsigned char* rgbDig 
); 

Parameters

  • strIn
    [no] Seqüência de caracteres de entrada a ser convertido em um número.
  • LCID
    [no] Identificador de localidade.
  • dwFlags
    [no] Permite que o chamador para controle análise, definindo, portanto, a sintaxe aceitável de um número.

    Se este campo for definido como zero, a entrada seqüência de caracteres devem conter nada, mas decimal dígitos.

    Definir cada bit definido sinalizador Permite análise desse recurso sintática.

    Análise automação padrão (por exemplo, conforme usado por VarI2FromStr) tem todos os sinalizadores definidos (NUMPRS_STD).

  • pnumprs
    [no] Resultados analisados.
  • rgbDig
    [out] Matriz preenchido com os valores para os dígitos na intervalo 0–7, 0–9 ou 0–15, dependendo se está o número octal, hexadecimal ou decimal. Todos os zeros à esquerda são retirados logoff.

    Para decimal números, à direita zeros também são retirados desativado, a menos que o número zero, no qual maiúsculas e minúsculas Um único zero dígito está presente.

Return Value

Retorna os valores HRESULT mostrados a seguinte tabela.

Valor Descrição

S_OK

O sucesso.

E_OUTOFMEMORY

Falha alocação memória interno. (Usado para DBCS somente para criar um copiar com todos os caracteres de largura mapeados estreito.)

DISP_E_TYPEMISMATCH

Não há nenhum válido número no seqüência de caracteres, ou não há nenhum parêntese de fechamento para coincidir com um abrindo um.

No antigo maiúsculas e minúsculas, cDig e cchUsed in a NUMPARSE estrutura será zero.

No segundo, o NUMPARSE estrutura e matriz dígito totalmente são atualizados, como se o parêntese de fechamento estava presente.

DISP_E_OVERFLOW

Para hexadecimal e octal dígitos, há mais dígitos do que caberá na matriz.

Para decimal, o expoente excede o máximo possível.

Em ambos os casos, o NUMPARSE estrutura e matriz dígito estão totalmente atualizados (para decimal, o cchUsed membro exclui o expoente inteiro).

Remarks

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Requirements

Header oleauto.h
Library oleaut32.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions