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	PASSIVE_LEVEL