wnsprintfA 函式 (shlwapi.h)

  • 發行項

接受可變長度自變數清單，並傳回自變數的值做為 printf 樣式格式化字串。

注意 請勿使用此函式。 如需替代函式，請參閱。
 

語法

int wnsprintfA(
  [out] PSTR  pszDest,
  [in]  int   cchDest,
  [in]  PCSTR pszFmt,
        ...   
);

參數

[out] pszDest

類型： PTSTR

緩衝區的指標，當此函式成功傳回時，會收到輸出字元串。

[in] cchDest

類型： int

pszDest 中允許的最大字元數。

[in] pszFmt

類型： PCTSTR

printf 樣式格式字串。 %s 格式識別碼不應該用在未繫結的表單中。 若要避免潛在的緩衝區溢出，請一律指定大小;實例 “%32s”。

...

包含要輸出之數據的其他參數。

傳回值

類型： int

傳回寫入緩衝區的字元數，不包括任何終止 的NULL 字元。 如果發生錯誤，則會傳回負值。

備註

安全性警告： 使用此函式不正確可能會危害應用程式的安全性。 複製的字串不保證為 Null 終止。 請考慮使用下列其中一個替代方案。 StringCbPrintf、 StringCbPrintfEx、 StringCbVPrintf、 StringCbVPrintfEx、 StringCchPrintf、 StringCchPrintfEx、 StringCchVPrintf 或 StringCchVPrintfEx。 您應該先檢閱 安全性考慮：Microsoft Windows Shell ，再繼續進行。

這是 sprintf的 Windows 版本。 它不支援浮點或指標類型。 它只支援左對齊旗標。

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (5.0 版或更新版本)