Compartilhar via

UlFromSzHex

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Converte uma cadeia de caracteres com término nulo de dígitos hexadecimal em um inteiro longo sem sinal.

Propriedade Valor
Arquivo de cabeçalho:
 Mapidefs.h
Implementado por:
 MAPI
Chamado por:
 Aplicativos cliente e provedores de serviços
 
ULONG UlFromSzHex(
LPCSTR lpsz
);

Parâmetros

Lpsz

[in] Ponteiro para a cadeia de caracteres terminada em nulo a ser convertida. O parâmetro lpsz não deve exceder 65536 caracteres.

Valor de retorno

UlFromSzHex retorna um inteiro longo não assinado. Se a cadeia de caracteres não começar com pelo menos um dígito hexadecimal, zero será retornado.

Comentários

A função UlFromSzHex para de converter quando atinge o primeiro caractere na cadeia de caracteres que não é um dígito hexadecimal. Por exemplo, dada a cadeia de caracteres "5a", UlFromSzHex retorna o valor inteiro 90. Dada a cadeia de caracteres "5g5h", a função retorna o valor inteiro 5. Dada a cadeia de caracteres "g5h5", UlFromSzHex retorna zero.

UlFromSzHex é sensível a diferenças diacríticas, mas permite 'a' por 'f' e 'A' por meio de 'F' para dígitos hexadecimal. Há suporte para cadeias de caracteres nos formatos Unicode e DBCS. O limite de comprimento em lpsz está em caracteres, não necessariamente bytes.