共用方式為


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 大小。 請考慮使用下列其中一個替代方案。 StringCbCatStringCbCatExStringCbCatNStringCbCatNExStringCchCat、StringCchCatExStringCchCatN 或 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 版或更新版本)