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

  • Статья

Функция RtlUnicodeStringValidate проверяет содержимое структуры UNICODE_STRING .

Синтаксис

NTSTRSAFEDDI RtlUnicodeStringValidate(
  [in] PCUNICODE_STRING SourceString
);

Параметры

[in] SourceString

Указатель на UNICODE_STRING структуру для проверки.

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

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

Код возврата Описание
STATUS_SUCCESS
 Это состояние успешного выполнения означает, что функция успешно завершена.
STATUS_INVALID_PARAMETER
 Это состояние ошибки означает, что функция получила недопустимый входной параметр. Дополнительные сведения см. в следующем списке.
 

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 не равно нулю.
Сведения о проверке значений NTSTATUS см. в разделе Использование значений NTSTATUS.

Комментарии

Указатель SourceString не может иметь значение NULL. Если необходимо указать значение указателя NULL , используйте функцию RtlUnicodeStringValidateEx .

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

Требования

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

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

RtlUnicodeStringValidateEx

UNICODE_STRING