通过

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->Buffer 等于 NULL ，但 SourceString->Length 或 SourceString->MaximumLength 不等于零。
有关如何测试 NTSTATUS 值的信息，请参阅 使用 NTSTATUS 值。

注解

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

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

要求

要求 值
最低受支持的客户端 在 Windows 的 Service Pack 1 (SP1) 及更高版本的 Windows 中可用。
目标平台 桌面
标头 ntstrsafe.h (包括 Ntstrsafe.h)
Library Ntstrsafe.lib
IRQL 如果正在操作的字符串始终驻留在内存中，则为 Any，否则PASSIVE_LEVEL

另请参阅

RtlUnicodeStringValidateEx

UNICODE_STRING