wvsprintfA 関数 (winuser.h)
引数のリストへのポインターを使用して、指定したバッファーに書式設定されたデータを書き込みます。 引数リストが指す項目は、書式制御文字列の対応する書式指定に従って変換され、出力バッファーにコピーされます。 関数は、書き込んだ文字に終端の null 文字を追加しますが、戻り値には終端の null 文字は文字数に含まれません。
構文
int wvsprintfA(
[out] LPSTR unnamedParam1,
[in] LPCSTR 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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
関連項目
概念
リファレンス