RtlUnicodeStringPrintf 函数 (ntstrsafe.h)
RtlUnicodeStringPrintf 函数创建一个文本字符串，其格式基于提供的格式信息，并将字符串存储在UNICODE_STRING结构中。
语法
NTSTRSAFEDDI RtlUnicodeStringPrintf(
[out] PUNICODE_STRING DestinationString,
[in] NTSTRSAFE_PCWSTR pszFormat,
...
);
参数
[out] DestinationString
指向接收格式化字符串 的UNICODE_STRING 结构的指针。 RtlUnicodeStringPrintf 从 pszFormat 指定的格式字符串和函数的参数列表创建此字符串。 字符串中的最大字符数为NTSTRSAFE_UNICODE_STRING_MAX_CCH。
[in] pszFormat
指向包含 printf 样式格式指令的以 null 结尾的文本字符串的指针。
...
可选。 函数根据 pszFormat 字符串包含的格式设置指令解释的参数列表。
返回值
RtlUnicodeStringPrintf 返回以下 NTSTATUS 值之一。
| 返回代码 | 说明 |
|---|---|
|
此 成功 状态意味着源数据已存在，字符串已复制且未截断，并且生成的目标缓冲区以 null 结尾。 |
|
此 警告 状态意味着操作由于缓冲区空间不足而未完成。 目标缓冲区包含预期结果的截断、以 null 结尾的版本。 |
|
此错误状态意味着函数收到了无效的输入参数。 有关详细信息，请参阅以下列表。 |
发生以下任一情况时，RtlUnicodeStringPrintf 返回STATUS_INVALID_PARAMETER值：
- DestinationString 参数指向的 UNICODE_STRING 结构的内容无效。
- 目标缓冲区已满。
- 存在 NULL 指针。
- 目标缓冲区的长度为零，但存在非零长度源字符串。
注解
RtlUnicodeStringPrintf 函数使用目标缓冲区的大小来确保字符串格式设置操作不会写入缓冲区末尾。 函数不会以 null 字符终止结果字符串。
如果格式字符串和目标字符串重叠，则函数的行为未定义。
pszFormat 和 DestinationString 指针不能为 NULL。 如果需要处理 NULL 指针值，请使用 RtlUnicodeStringPrintfEx 函数。
有关安全字符串函数的详细信息，请参阅 使用安全字符串函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows XP 中提供 Service Pack 1 (SP1) 及更高版本的 Windows。 |
| 目标平台 | 桌面 |
| 标头 | ntstrsafe.h (包括 Ntstrsafe.h) |
| Library | Ntstrsafe.lib |
| IRQL | 如果正在操作的字符串始终驻留在内存中，则为 Any，否则PASSIVE_LEVEL |