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-> (WCHAR) 长度百分比大小不等于零。
  • SourceString->WCHAR) 最大大小 (最大大小不等于零。
  • SourceString->长度 大于 SourceString->MaximumLength
  • SourceString->MaximumLength 大于 NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof (WCHAR) 。
  • SourceString->缓冲区 等于 NULL ,但 SourceString->LengthSourceString->MaximumLength 不等于零。
有关如何测试 NTSTATUS 值的信息,请参阅 使用 NTSTATUS 值

注解

SourceString 指针不能为 NULL。 如果需要指定 NULL 指针值,请使用 RtlUnicodeStringValidateEx 函数。

有关安全字符串函数的详细信息,请参阅 使用安全字符串函数

要求

   
最低受支持的客户端 在 Windows XP 中提供 Service Pack 1 (SP1) 及更高版本的 Windows。
目标平台 桌面
Header ntstrsafe.h (包括 Ntstrsafe.h)
Library Ntstrsafe.lib
IRQL PASSIVE_LEVEL

另请参阅

RtlUnicodeStringValidateEx

UNICODE_STRING