wvsprintfW 関数 (winuser.h)
引数のリストへのポインターを使用して、書式設定されたデータを指定されたバッファーに書き込みます。 引数リストが指す項目は、書式制御文字列の対応する書式指定に従って変換され、出力バッファーにコピーされます。 関数は、書き込む文字に終端の null 文字を追加しますが、戻り値には終端の null 文字は文字数に含まれません。
構文
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 |
関連項目
概念
リファレンス