strNCatA 函式 (shlwapi.h)

將指定數目的字元從一個字串的開頭附加至另一個字串的結尾。

注意 請勿使用此函式或 StrCatN 宏。 如需替代函式，請參閱。

 

語法

PSTR StrNCatA(
  [in, out] PSTR  psz1,
            PCSTR psz2,
            int   cchMax
);

參數

[in, out] psz1

類型： PTSTR

函式附加 psz2字元的 Null 終止字串指標。 它必須夠大，才能保存合併字串加上終止的 Null 字元。

psz2

類型： PCTSTR

要附加之 Null 終止字串的指標。

cchMax

類型： int

要從psz2開頭附加至psz1的字元數。

傳回值

類型： PTSTR

傳回 psz1的指標，其中包含合併的字串。

備註

安全性警告： 使用此函式不正確可能會危害應用程式的安全性。 第一個引數 psz1必須夠大，才能保存 psz2 和結尾 '\0'，否則可能會發生緩衝區滿溢。 如果發生存取違規，緩衝區滿溢可能會導致對應用程式的拒絕服務攻擊。 在最糟的情況下，緩衝區滿溢可能會讓攻擊者將可執行檔程式碼插入您的進程，特別是 psz1 是堆疊式緩衝區時。 請注意，最後一個引數 cchMax是要複製到 psz1的字元數，不一定是以位元組為單位 的 psz1 大小。 請考慮使用下列其中一個替代方案。 StringCbCat、StringCbCatEx、StringCbCatN、StringCbCatNEx、StringCchCat、StringCchCatEx、StringCchCatN 或 StringCchCatNEx。 您應該先檢閱 安全性考慮：Microsoft Windows Shell ，再繼續進行。

注意

shlwapi.h 標頭會將 StrNCat 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shlwapi.h
程式庫	Shlwapi.lib
Dll	Shlwapi.dll (4.71 版或更新版本)