UlFromSzHex

Область применения: Outlook 2013 | Outlook 2016

Преобразует строку, завершаемую значением NULL из шестнадцатеричных цифр, в целое число без знака.

Свойство	Значение
Файл заголовка:	Mapidefs.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения и поставщики услуг

ULONG UlFromSzHex(
LPCSTR lpsz
);

Параметры

lpsz

[в] Указатель на преобразуемую строку, завершаемую значением NULL. Параметр lpsz не должен превышать 65536 символов.

Возвращаемое значение

UlFromSzHex возвращает длинное целое число без знака. Если строка не начинается хотя бы с одной шестнадцатеричной цифры, возвращается ноль.

Замечания

Функция UlFromSzHex прекращает преобразование, когда она достигает первого символа в строке, которая не является шестнадцатеричной цифрой. Например, учитывая строку "5a", UlFromSzHex возвращает целочисленное значение 90. Учитывая строку "5g5h", функция возвращает целочисленное значение 5. Учитывая строку "g5h5", UlFromSzHex возвращает ноль.

UlFromSzHex чувствителен к диакритических различиям, но допускает как "a" через "f", так и "A" через "F" для шестнадцатеричных цифр. Поддерживаются строки в форматах Юникод и DBCS. Длина lpsz ограничена символами, а не обязательно байтами.