wvsprintfW 関数 (winuser.h)

引数のリストへのポインターを使用して、書式設定されたデータを指定されたバッファーに書き込みます。 引数リストが指す項目は、書式制御文字列の対応する書式指定に従って変換され、出力バッファーにコピーされます。 関数は、書き込む文字に終端の null 文字を追加しますが、戻り値には終端の null 文字は文字数に含まれません。

警告 は使用しないでください。 代わりに、 StringCbVPrintf、StringCbVPrintfExStringCchVPrintfStringCchVPrintfEx のいずれかの関数を使用することを検討 してください。 「セキュリティに関する考慮事項」を参照してください。
 

構文

int wvsprintfW(
  [out] LPWSTR  unnamedParam1,
  [in]  LPCWSTR unnamedParam2,
  [in]  va_list arglist
);

パラメーター

[out] unnamedParam1

種類: LPTSTR

書式設定された出力を受け取るバッファー。 バッファーの最大サイズは 1,024 バイトです。

[in] unnamedParam2

種類: LPCTSTR

書式制御の仕様。 この文字列には、通常の ASCII 文字に加えて、各引数の書式指定が表示されます。 書式指定の詳細については、 wsprintf 関数を参照してください。

[in] arglist

種類: va_list

このリストの各要素は、書式制御文字列の引数を指定します。 引数の数値、型、および解釈は、 lpFmt パラメーターの対応する書式制御仕様によって異なります。

戻り値

型: int

関数が成功した場合、戻り値はバッファーに格納されている文字数であり、終端の null 文字はカウントされません。

関数が失敗した場合、戻り値は予想される出力の長さより小さくなります。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

関数は、書式制御文字列を、文字列の最初の文字から始まる文字で出力バッファー文字にコピーします。 文字列で書式指定が見つかった場合、関数は次に使用可能な引数の値を取得し (リストの最初の引数から始まる)、その値を指定された形式に変換し、結果を出力バッファーにコピーします。 関数は、書式制御文字列の末尾に達するまで、文字をコピーし、この方法で書式指定を拡張し続けます。 書式指定よりも多くの引数がある場合、余分な引数は無視されます。 すべての書式指定に十分な引数がない場合、結果は未定義になります。

注意

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

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll

関連項目

概念

リファレンス

StringCbPrintf

StringCbPrintfEx

StringCbVPrintf

StringCbVPrintfEx

StringCchPrintf

StringCchPrintfEx

StringCchVPrintf

StringCchVPrintfEx

文字列

wsprintf