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

傳回碼 Description
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 "字串" RtlStringCchLengthA
 

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

規格需求

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

另請參閱

RtlStringCbLength