共用方式為


wvsprintfA 函式 (winuser.h)

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

警告 請勿使用。 請考慮改用下列其中一個函式: StringCbVPrintfStringCbVPrintfExStringCchVPrintfStringCchVPrintfEx。 請參閱安全性考慮。
 

語法

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

規格需求

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

另請參閱

概念

參考

StringCbPrintf

StringCbPrintfEx

StringCbVPrintf

StringCbVPrintfEx

StringCchPrintf

StringCchPrintfEx

StringCchVPrintf

StringCchVPrintfEx

字串

wsprintf