wnsprintfA function (shlwapi.h)

Takes a variable-length argument list and returns the values of the arguments as a printf-style formatted string.

Syntax

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

Parameters

[out] pszDest

Type: PTSTR

A pointer to a buffer that, when this function returns successfully, receives the output string.

[in] cchDest

Type: int

The maximum number of characters allowed in pszDest.

[in] pszFmt

Type: PCTSTR

A printf-style format string. The %s format identifier should never be used in an unbounded form. To avoid potential buffer overruns, always specify a size; for instance "%32s".

...

Additional parameters that contain the data to be output.

Return value

Type: int

Returns the number of characters written to the buffer, excluding any terminating NULL characters. A negative value is returned if an error occurs.

Remarks

Security Warning:  Using this function incorrectly can compromise the security of your application. The copied string is not guaranteed to be null-terminated. Consider using one of the following alternatives. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintf, StringCchPrintfEx, StringCchVPrintf, or StringCchVPrintfEx. You should review Security Considerations: Microsoft Windows Shell before continuing.

This is a Windows version of sprintf. It does not support floating-point or pointer types. It supports only the left alignment flag.

Requirements