通过

RtlUnalignedStringCbLengthW 函数 (ntstrsafe.h)

  • 项目

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

语法

NTSTRSAFEDDI RtlUnalignedStringCbLengthW(
  [in]            STRSAFE_PCUNZWCH psz,
  [in]            size_t           cbMax,
  [out, optional] size_t           *pcbLength
);

参数

[in] psz

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

[in] cbMax

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

[out, optional] pcbLength

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

返回值

RtlUnalignedStringCbLengthW 返回以下 NTSTATUS 值之一。

返回代码 说明
STATUS_SUCCESS
 此 成功 状态表示 psz 参数指定的字符串不为 NULL，并且字符串的长度 (包括终止 NULL 字符) 小于或等于 cbMax 字节。
STATUS_INVALID_PARAMETER
 此错误状态表示 psz 中的值为 NULL，cbMax 大于 NTSTRSAFE_MAX_CCH * sizeof (WCHAR，或 psz 长于 cbMax。
 

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

注解

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

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

要求

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

另请参阅

RtlStringCbLength