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 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winuser.h (Windows.h を含む) |
| ライブラリ | User32.lib |
| DLL | User32.dll |
関連項目
概念
リファレンス
StringCbPrintfEx の
StringCbVPrintf の
StringCbVPrintfEx の
wsprintf の