共用方式為

RtlUnalignedStringCchLengthW 函式 （ntstrsafe.h）

  • 發行項

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

語法

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

參數

[in] psz

提供緩衝區的指標，其中包含 null 終止字串，其長度 RtlUnalignedStringCchLengthW 將會檢查。

[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）
連結庫 Ntstrsafe.lib
IRQL 如果所作的字串一律位於記憶體中，則為任何 ，否則PASSIVE_LEVEL

另請參閱

RtlStringCchLength