CStringT::FormatMessageV

  • Article

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, _printf_l, wprintf, _wprintf_l

Other Resources

CStringT Members