通过

RtlUnalignedStringCchLengthW 函数 (ntstrsafe.h)

  • 项目

RtlUnalignedStringCchLengthW 函数是 RtlStringCchLength 函数的一个版本，它接受指向 Unicode 字符字符串的未对齐指针。

语法

NTSTRSAFEDDI RtlUnalignedStringCchLengthW(
  [in]            STRSAFE_PCUNZWCH psz,
  [in]            size_t           cchMax,
  [out, optional] size_t           *pcchLength
);

参数

[in] psz

提供指向缓冲区的指针，该缓冲区包含其长度 RtlUnalignedStringCchLengthW 将检查的以 null 结尾的字符串。

[in] cchMax

提供 psz 指向的缓冲区中允许的最大字符数，包括终止 NULL 字符。 此值不能超过 NTSTRSAFE_MAX_CCH。

[out, optional] pcchLength

可选。 如果调用方提供非 NULL 地址指针，则函数会加载包含 psz 指向的缓冲区中包含的字符串的长度（以字符为单位）的地址。 长度不包括字符串的终止 NULL 字符。

返回值

RtlUnalignedStringCchLengthW 返回以下 NTSTATUS 值之一。

返回代码 说明
STATUS_SUCCESS
 此 成功 状态表示 psz 参数不是 NULL 的字符串，并且字符串的长度 (包括终止 NULL 字符) 小于或等于 cchMax 字符。
STATUS_INVALID_PARAMETER
 此错误状态意味着 psz 中的值为 NULL、cchMax 大于 NTSTRSAFE_MAX_CCH 或 psz 长于 cchMax。
 

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

注解

RtlUnalignedStringCchLengthW 函数可用于处理器体系结构，例如基于 Itanium 和基于 x64 的处理器体系结构，当软件尝试访问未对齐的数据时，这些体系结构会导致对齐异常。 在这些处理器上，可以使用 RtlUnalignedStringCchLengthW 而不是 RtlStringCchLength 来避免对齐异常。 (对于不会导致对齐异常的处理器， RtlUnalignedStringCchLengthW 等效于 RtlStringCchLength.)

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

要求

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

另请参阅

RtlStringCchLength