wvsprintfW 函式 (winuser.h)

發行項
03/04/2024

使用自變數清單的指標，將格式化的數據寫入指定的緩衝區。自變數清單所指向的專案會根據格式控制字串中的對應格式規格，轉換並複製到輸出緩衝區。函式會將終止 Null 字元附加至寫入的字元，但傳回值不包含其字元計數中的終止 Null 字元。

警告請勿使用。請考慮改用下列其中一個函式： StringCbVPrintf、 StringCbVPrintfEx、 StringCchVPrintf 或 StringCchVPrintfEx。請參閱安全性考慮。

語法

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 預處理器常數的定義，將 wvsprintf 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll