RtlUnalignedStringCbLengthW 函式 (ntstrsafe.h)

  • 發行項

RtlUnalignedStringCbLengthW 函式是 RtlStringCbLength 函式的版本，可接受 Unicode 字符字串的未對齊指標。

語法

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

參數

[in] psz

提供緩衝區的指標，其中包含長度 為 RtlUnalignedStringCbLengthW 的 Null 終止字串。

[in] cbMax

提供 psz 指向之緩衝區中允許的最大位元組數目，包括終止的 NULL 字元。 此值不能超過 NTSTRSAFE_MAX_CCH * sizeof (WCHAR) 。

[out, optional] pcbLength

選擇性。 如果呼叫端提供非 NULL 位址指標，函式會載入包含 於 psz 所指向緩衝區中之字串的長度，以位元組為單位的位址。 長度不包含字串的終止NULL字元。

傳回值

RtlUnalignedStringCbLengthW 會傳回下列其中一個 NTSTATUS 值。

傳回碼 Description
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 XP 中提供 Service Pack 1 (SP1) 和更新版本的 Windows。
目標平台 桌面
標頭 ntstrsafe.h (包含 Ntstrsafe.h)
程式庫 Ntstrsafe.lib
IRQL 如果正在操作的字串一律位於記憶體中，則為任何 ，否則PASSIVE_LEVEL

另請參閱

RtlStringCbLength