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

傳回碼 描述
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 “string” RtlStringCbLengthA
 

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

要求

要求 價值
最低支援的用戶端 Windows XP 中提供 Service Pack 1 （SP1） 和更新版本的 Windows。
目標平臺 桌面
標頭 ntstrsafe.h （包括 Ntstrsafe.h）
連結庫 Ntstrsafe.lib
IRQL 如果所作的字串一律位於記憶體中，則為任何 ，否則PASSIVE_LEVEL

另請參閱

RtlStringCchLength

  • 上次更新時間：