Функция RtlUnalignedStringCbLengthW (ntstrsafe.h)

  • Статья

Функция RtlUnalignedStringCbLengthW — это версия функции RtlStringCbLength , которая принимает неровный указатель на строку символов Юникода.

Синтаксис

NTSTRSAFEDDI RtlUnalignedStringCbLengthW(
  [in]            STRSAFE_PCUNZWCH psz,
  [in]            size_t           cbMax,
  [out, optional] size_t           *pcbLength
);

Параметры

[in] psz

Предоставляет указатель на буфер, содержащий строку со значением NULL, длина которой RtlUnalignedStringCbLengthW будет проверка.

[in] cbMax

Предоставляет максимальное число байтов, разрешенных в буфере, на который указывает psz , включая завершающий символ NULL. Это значение не может превышать NTSTRSAFE_MAX_CCH * sizeof(WCHAR).

[out, optional] pcbLength

Необязательный элемент. Если вызывающий объект предоставляет указатель на адрес, отличный от NULL , функция загружает адрес длиной в байтах строки, содержащейся в буфере, на который указывает psz . Длина не включает завершающий символ NULL строки.

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

RtlUnalignedStringCbLengthW возвращает одно из следующих значений NTSTATUS.

Код возврата Описание
STATUS_SUCCESS
 Это состояние успешного выполнения означает, что строка, указанная параметром psz , не была NULL, а длина строки (включая завершающий символ NULL) была меньше или равна cbMax байтам.
STATUS_INVALID_PARAMETER
 Это состояние ошибки означает, что значение в psz равно NULL, cbMax больше NTSTRSAFE_MAX_CCH * sizeof(WCHAR, или psz больше cbMax.
 

Сведения о проверке значений NTSTATUS см. в разделе Использование значений NTSTATUS.

Комментарии

Функция RtlUnalignedStringCbLengthW доступна для процессорных архитектур, таких как itanium и x64, которые вызывают исключения выравнивания, когда программное обеспечение пытается получить доступ к неровным данным. На этих процессорах можно использовать RtlUnalignedStringCbLengthW вместо функции RtlStringCbLength , чтобы избежать исключений выравнивания. (Для процессоров, которые не вызывают исключения выравнивания, RtlUnalignedStringCbLengthW эквивалентен RtlStringCbLength.)

Дополнительные сведения о безопасных строковых функциях см. в разделе Использование безопасных строковых функций.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows XP с пакетом обновления 1 (SP1) и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть ntstrsafe.h (включая Ntstrsafe.h)
Библиотека Ntstrsafe.lib
IRQL Любое значение, если строки, которыми осуществляется управление, всегда находятся в памяти, в противном случае PASSIVE_LEVEL

См. также раздел

RtlStringCbLength