StopWatchFlush 函数 (shlwapi.h)

[StopWatchFlush 可用于“要求”部分中指定的操作系统。 在后续版本中,它可能已更改或不可用。]

如果启用了性能日志记录,则写出性能统计信息。

语法

DWORD StopWatchFlush();

返回值

类型:DWORD

成功时ERROR_SUCCESS,失败时出现错误代码。 可能的错误代码包括以下内容:

返回代码 说明
ERROR_NO_DATA
未收集任何性能日志。
ERROR_INVALID_DATA
未启用性能记录。

注解

性能日志将写入 Windows 目录中的 shperf.log 文件。 如果启用了消息性能日志,则消息性能日志将写入 Windows 目录中的 msgtrace.log 文件。 如果调用 StopWatchFlush,则必须具有在 Windows 目录中创建和修改文件的权限。

调用 StopWatchFlush 会在将性能日志写入shperf.log文件后将其清除。

有关性能日志中记录的信息的说明,请参阅 StopWatchMode 函数。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
DLL Shlwapi.dll (5.0 或更高版本)