Функция RtlUnicodeStringValidate (ntstrsafe.h)
Функция RtlUnicodeStringValidate проверяет содержимое структуры UNICODE_STRING .
Синтаксис
NTSTRSAFEDDI RtlUnicodeStringValidate(
[in] PCUNICODE_STRING SourceString
);
Параметры
[in] SourceString
Указатель на UNICODE_STRING структуру для проверки.
Возвращаемое значение
RtlUnicodeStringValidate возвращает одно из следующих значений NTSTATUS.
| Код возврата | Описание |
|---|---|
|
Это состояние успешного выполнения означает, что функция успешно завершена. |
|
Это состояние ошибки означает, что функция получила недопустимый входной параметр. Дополнительные сведения см. в следующем списке. |
RtlUnicodeStringValidate возвращает значение STATUS_INVALID_PARAMETER, если происходит одно из следующих действий:
- SourceString->Длина % sizeof (WCHAR) не равна нулю.
- SourceString->Значение MaximumLength % sizeof(WCHAR) не равно нулю.
- SourceString->Длина больше , чем SourceString->MaximumLength.
- SourceString->MaximumLength больше NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
- SourceString->Значение буфера равно NULL , но значение SourceString->Length или SourceString->MaximumLength не равно нулю.
Комментарии
Указатель SourceString не может иметь значение NULL. Если необходимо указать значение указателя NULL , используйте функцию RtlUnicodeStringValidateEx .
Дополнительные сведения о безопасных строковых функциях см. в разделе Использование безопасных строковых функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows XP с пакетом обновления 1 (SP1) и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ntstrsafe.h (включая Ntstrsafe.h) |
| Библиотека | Ntstrsafe.lib |
| IRQL | Любое значение, если строки, которыми осуществляется управление, всегда находятся в памяти, в противном случае PASSIVE_LEVEL |