RtlUnicodeStringValidateEx 函数 (ntstrsafe.h)

RtlUnicodeStringValidateEx 函数验证UNICODE_STRING结构的内容。

语法

NTSTRSAFEDDI RtlUnicodeStringValidateEx(
  [in] PCUNICODE_STRING SourceString,
  [in] DWORD            dwFlags
);

[in] SourceString

可选。指向要验证 的UNICODE_STRING 结构的指针。此指针可以为 NULL，但前提是在 dwFlags 中设置了STRSAFE_IGNORE_NULLS。

[in] dwFlags

定义了以下标志：

如果设置了此标志，则源指针可以为 NULL。 RtlUnicodeStringValidateEx 将 NULL 源缓冲区指针视为空字符串 (TEXT (“”) ) 。

RtlUnicodeStringValidateEx 返回以下 NTSTATUS 值之一。

返回代码	说明
STATUS_SUCCESS	此成功状态表示函数已成功完成。
STATUS_INVALID_PARAMETER	此错误状态表示函数收到了无效的输入参数。有关详细信息，请参阅以下列表。

如果未在 dwFlags 中设置STRSAFE_IGNORE_NULLS，则发生下列情况之一时， RtlUnicodeStringValidateEx 将返回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 不等于零。
为 dwFlags 指定了无效标志。

有关如何测试 NTSTATUS 值的信息，请参阅使用 NTSTATUS 值。

除非设置了STRSAFE_IGNORE_NULLS标志， 否则 SourceString 指针不能为 NULL 。

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

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