共用方式為

RtlStringCchLengthA 函式 （ntstrsafe.h）

  • 發行項

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

語法

NTSTRSAFEDDI RtlStringCchLengthA(
  [in] STRSAFE_PCNZCH psz,
  [in] size_t         cchMax,
       size_t         *pcchLength
);

參數

[in] psz

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

[in] cchMax

psz所指向之緩衝區中允許的最大字元數，包括終止的 Null 字元。 此值不能超過 NTSTRSAFE_MAX_CCH。

pcchLength

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

傳回值

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

傳回碼 描述
STATUS_SUCCESS
 此成功狀態表示 psz 的字串未 NULL，且字串長度（包括終止 Null 字元）小於或等於 cchMax 字元。
STATUS_INVALID_PARAMETER
 此錯誤狀態表示 psz 中的值 NULL、cchMax 大於 NTSTRSAFE_MAX_CCH，或 psz大於 cchMax。

言論

RtlStringCchLengthW 和 RtlStringCchLengthA，而不是使用 strlen。 它們用來確保字串不大於指定的長度，以字元為單位。 如果符合該條件，RtlStringCchLengthW 和 RtlStringCchLengthA 傳回字元中字符串的目前長度，不包括終止的 Null 字符。

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

字串數據類型 字串常值 功能
WCHAR L“string” RtlStringCchLengthW
char “string” RtlStringCchLengthA
 

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

要求

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

另請參閱

RtlStringCbLength