StrCpyW 関数 (shlwapi.h)

1 つの文字列を別の文字列にコピーします。

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

 

構文

PWSTR StrCpyW(
  [out] PWSTR  psz1,
  [in]  PCWSTR psz2
);

パラメーター

[out] psz1

種類: PTSTR

この関数が正常に返されると、コピーした文字列を受け取るバッファーへのポインター。 この文字列は null で終わる保証はありません。

[in] psz2

種類: PCTSTR

null で終わるソース文字列へのポインター。

戻り値

種類: PTSTR

psz1 へのポインターを返します。

解説

セキュリティの警告: この関数を誤って使用すると、アプリケーションのセキュリティが損なわれる可能性があります。 最初の引数 psz1 は、 psz2 と終了 '\0' を保持するのに十分な大きさにする必要があります。それ以外の場合は、バッファー オーバーランが発生する可能性があります。 アクセス違反が発生した場合、バッファー オーバーランによってアプリケーションに対するサービス拒否攻撃が発生する可能性があります。 最悪の場合、バッファー オーバーランにより、特に psz1 がスタック ベースのバッファーである場合に、攻撃者が実行可能コードをプロセスに挿入する可能性があります。 StringCbCopy、StringCbCopyEx、StringCbCopyN、StringCbCopyNEx、StringCchCopy、StringCchCopyEx、StringCchCopyN、または StringCchCopyNEx のいずれかを使用することを検討してください。 続行する前に 、「セキュリティに関する考慮事項: Microsoft Windows Shell 」を確認する必要があります。

要件

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