Writes formatted data to the specified string. The size of the destination buffer is provided to the function to ensure that it does not write past the end of this buffer.
写入有格式的数据到指定的字符串里。目标缓存的大小被用来确保写入数据时缓冲区溢出。
StringCbPrintf is a replacement for the following functions:
StringCbPrintf是一个代替一下函数的函数
Syntax 语法
HRESULT StringCbPrintf( _Out_ LPTSTR pszDest, _In_ size_t cbDest, _In_ LPCTSTR pszFormat, _In_ ... );
Parameters 参数
-
pszDest [out]
-
Type: LPTSTR
The destination buffer, which receives the formatted, null-terminated string created from pszFormat and its arguments.
目标缓存。按照pszFormat格式从后面的参数创建的嗲有空字符的字符串
cbDest [in]
-
Type: size_t
The size of the destination buffer, in bytes. This value must be sufficiently large to accommodate the final formatted string plus the terminating null character. The maximum number of bytes allowed is
STRSAFE_MAX_CCH * sizeof(TCHAR)
.目标缓存的字节大小。这个值必须足够大。
pszFormat [in]
-
Type: LPCTSTR
The format string. This string must be null-terminated.
格式字符串。这个字符串必须为空字符终止。
... [in]
-
The arguments to be inserted into the pszFormat string.
被插入到格式字符串里的参数。
Return value 返回值
Type: HRESULT
This function can return one of the following values. It is strongly recommended that you use the SUCCEEDED and FAILED macros to test the return value of this function.