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 值。

傳回碼 Description
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)
程式庫 Ntstrsafe.lib
IRQL 如果正在操作的字串一律位於記憶體中，則為任何 ，否則PASSIVE_LEVEL

另請參閱

RtlStringCchLength