StrCatBuffA 関数 (shlwapi.h)

ある文字列から別の文字列の末尾に文字をコピーして追加します。

メモ は使用しないでください。 代替関数については、「解説」を参照してください。

 

構文

PSTR StrCatBuffA(
  [in, out] PSTR  pszDest,
  [in]      PCSTR pszSrc,
            int   cchDestBuffSize
);

パラメーター

[in, out] pszDest

種類: PTSTR

null 終端文字列へのポインター。 この関数が正常に返されると、この文字列には、 pszSrc という文字列が付加された元のコンテンツが含まれます。

[in] pszSrc

種類: PCTSTR

pszDest に追加する文字列へのポインター。

cchDestBuffSize

型: int

pszDest が指すバッファーのサイズ (文字単位)。 この値は、結合された文字列の長さと終端の null 文字の長さ以上である必要があります。 バッファーが小さすぎて文字列全体に収まらない場合、文字列は切り捨てられます。

戻り値

種類: PTSTR

コピー先文字列へのポインターを返します。

注釈

セキュリティの警告: この関数を誤って使用すると、アプリケーションのセキュリティが損なわれる可能性があります。 最後の文字列は、null で終わる保証はありません。 StringCbCat、StringCbCatEx、StringCbCatN、StringCbCatNEx、StringCchCatEx、StringCchCatEx、StringCchCatN、StringCchCatNEx のいずれかを使用することを検討してください。 続行する前に 、「セキュリティに関する考慮事項: Microsoft Windows Shell 」を確認する必要があります。

注意

shlwapi.h ヘッダーは、StrCatBuff をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 5.0 以降)