Функция 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.
Код возврата | Описание |
---|---|
|
Это состояние успешного выполнения означает, что строка, указанная параметром psz , не была NULL, а длина строки (включая завершающий символ NULL) была меньше или равна cbMax байтам. |
|
Это состояние ошибки означает, что значение в 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 |