共用方式為

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 psz 1 的字元數。

傳回值

類型：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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlwapi.h
連結庫 Shlwapi.lib
DLL Shlwapi.dll （4.71 版或更新版本）