Функция 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->Length % sizeof(WCHAR) не равно нулю.
SourceString->MaximumLength % sizeof(WCHAR) не равно нулю.
SourceString->Length больше 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 (include Ntstrsafe.h)
библиотеки	Ntstrsafe.lib
IRQL	Любой, если управляемые строки всегда находятся в памяти, в противном случае PASSIVE_LEVEL

Были ли сведения на этой странице полезными?