共用方式為

RtlStringCbLengthA 函式 (ntstrsafe.h)

  • 發行項

RtlStringCbLengthW 和 RtlStringCbLengthA 函式會決定所提供字串的長度，以位元組為單位。

語法

NTSTRSAFEDDI RtlStringCbLengthA(
  [in] STRSAFE_PCNZCH psz,
  [in] size_t         cbMax,
       size_t         *pcbLength
);

參數

[in] psz

緩衝區的指標，其中包含以 Null 結束的字串，將會檢查其長度。

[in] cbMax

psz 所指向之緩衝區中允許的最大位元組數目，包括終止的 Null 字元。

若為 Unicode 字串，最大位元節數目為 NTSTRSAFE_MAX_CCH * sizeof (WCHAR) 。

對於 ANSI 字串，最大位元組數目是NTSTRSAFE_MAX_CCH * sizeof (char) 。

pcbLength

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

傳回值

函式會傳回下表所列的其中一個NTSTATUS值。 如需如何測試 NTSTATUS 值的資訊，請參閱 使用 NTSTATUS 值。

傳回碼 Description
STATUS_SUCCESS
 此 成功 狀態表示 psz 的字串不是 NULL，而且字串長度 (包含終止 Null 字元) 小於或等於 cbMax 字元。
STATUS_INVALID_PARAMETER
 此錯誤狀態表示 psz 中的值為 NULL、cbMax 大於 NTSTRSAFE_MAX_CCH * sizeof (TCHAR) ，或 psz 超過 cbMax。

備註

應該使用 RtlStringCbLengthW 和 RtlStringCbLengthA ，而不是 strlen。 使用這些函式來確保字串不大於指定的長度，以位元組為單位。 如果符合該條件， RtlStringCbLengthW 和 RtlStringCbLengthA 會以位元組為單位傳回字串的目前長度，不包括用於終止 Null 字元的位元組。

使用 RtlStringCbLengthW 來處理 Unicode 字串和 RtlStringCbLengthA 來處理 ANSI 字串。 您使用的表單取決於您的資料，如下表所示。

字串資料類型 字串常值 函式
WCHAR L“string” RtlStringCbLengthW
char "字串" RtlStringCbLengthA
 

如需安全字串函式的詳細資訊，請參閱 使用安全字串函式。

規格需求

需求 值
最低支援的用戶端 Windows XP 中提供 Service Pack 1 (SP1) 和更新版本的 Windows。
目標平台 桌面
標頭 ntstrsafe.h (包含 Ntstrsafe.h)
程式庫 Ntstrsafe.lib
IRQL 如果正在操作的字串一律位於記憶體中，則為任何 ，否則PASSIVE_LEVEL

另請參閱

RtlStringCchLength