StrNCatW 関数 (shlwapi.h)
1 つの文字列の先頭から別の文字列の末尾に、指定した数の文字を追加します。
構文
PWSTR StrNCatW(
[in, out] PWSTR psz1,
PCWSTR 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 |
Library | Shlwapi.lib |
[DLL] | Shlwapi.dll (バージョン 4.71 以降) |