Share via


CStringT::FormatMessageV

Formats a message string using a variable argument list.

void FormatMessageV(
   PCXSTR pszFormat,
   va_list* pArgList
);

Parameters

  • pszFormat
    Points to the format-control string. It will be scanned for inserts and formatted accordingly. The format string is similar to run-time function printf-style format strings, except it allows for the parameters to be inserted in an arbitrary order.

  • pArgList
    Pointer to a list of arguments.

Remarks

The function requires a message definition as input, determined by pszFormat. The function copies the formatted message text and a variable list of arguments to the CStringT object, processing any embedded insert sequences if requested.

Note

FormatMessageV calls CStringT::FormatMessage, which attempts to allocate system memory for the newly formatted string. If this attempt fails, a memory exception is automatically thrown.

For more information, see the Windows FormatMessage function in the Windows SDK.

Requirements

Header: cstringt.h

See Also

Reference

CStringT Class

CStringT::FormatMessage

printf_s, _printf_s_l, wprintf_s, _wprintf_s_l