共用方式為


RtlStringCbCatNA 函式 (ntstrsafe.h)

RtlStringCbCatNWRtlStringCbCatNA 函式會串連兩個字節計數的字元串,同時限制附加字元串的大小。

語法

NTSTRSAFEDDI RtlStringCbCatNA(
  [in, out] NTSTRSAFE_PSTR pszDest,
  [in]      size_t         cbDest,
  [in]      STRSAFE_PCNZCH pszSrc,
            size_t         cbToAppend
);

參數

[in, out] pszDest

緩衝區的指標,在輸入時會包含 null 終止的字串串,pszSrc 串連。 在輸出中,這是包含整個結果字串的目的地緩衝區。 pszSrc的字串,最多 cbToAppend 個字節,會新增至 pszDest 的字元串結尾,並以 null 字元終止。

[in] cbDest

目的地緩衝區的大小,以位元組為單位。 緩衝區必須夠大,才能同時包含字串和終止的 Null 字元。

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

針對 ANSI 字串,位元組數目上限為 NTSTRSAFE_MAX_CCH * sizeof(char)。

[in] pszSrc

Null 終止字串的指標。 此字串會串連至緩衝區中包含在 pszDest 之字串的結尾。

cbToAppend

要附加至緩衝區中 pszDest之字元串的最大位元組數。

傳回值

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

傳回碼 描述
STATUS_SUCCESS
成功 狀態表示源數據存在、字串串連而不截斷,而結果目的地緩衝區會以 Null 結束。
STATUS_BUFFER_OVERFLOW
警告 狀態表示串連作業因緩衝區空間不足而未完成。 目的地緩衝區包含已截斷且以 Null 終止之預期結果的版本。
STATUS_INVALID_PARAMETER
這個 錯誤 狀態表示函式收到無效的輸入參數。 如需詳細資訊,請參閱下列段落。

函式會在下列情況下傳回STATUS_INVALID_PARAMETER值:

  • cbDest 中的值大於緩衝區大小上限。
  • 目的地緩衝區已滿。
  • NULL 指標存在。
  • 目的地緩衝區的長度為零,但存在非零長度的來源字串。

言論

RtlStringCbCatNWRtlStringCbCatNA 應使用,而不是下列函式:

  • strncat
  • wcsncat
目的地緩衝區的大小,以位元組為單位,會提供給 RtlStringCbCatNWRtlStringCbCatNA,以確保它們不會寫入緩衝區結尾。

使用 RtlStringCbCatNW 來處理 Unicode 字串,並 RtlStringCbCatNA 來處理 ANSI 字符串。 您使用的表單取決於您的資料,如下表所示

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

如果 pszSrcpszDest 指向重迭字串,則函式的行為是未定義的。

pszSrcpszDest 都不能 NULL。 如果您需要處理 NULL 字串指標值,請使用 RtlStringCbCatNEx

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

要求

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

另請參閱

RtlStringCbCat

RtlStringCbCatNEx

RtlStringCchCatN