wvsprintfW 函式（winuser.h）

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

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winuser.h （包括 Windows.h）
連結庫	User32.lib
DLL	User32.dll