性能数据帮助程序错误代码

  • 项目

所有性能数据帮助程序 (PDH) 函数返回 类型为 PDH_STATUS 的值。 如果函数成功，则返回值为 ERROR_SUCCESS。 否则，函数将返回 系统错误代码 或 PDH 错误代码。 若要检索应用程序中错误的说明文本，请使用 FormatMessage 函数，如以下示例所示。

#include <windows.h>
#include <stdio.h>
#include <pdhmsg.h>

void main(void)
{
    HANDLE hPdhLibrary = NULL;
    LPWSTR pMessage = NULL;
    DWORD dwErrorCode = PDH_PLA_ERROR_ALREADY_EXISTS;

    hPdhLibrary = LoadLibrary(L"pdh.dll");
    if (NULL == hPdhLibrary)
    {
        wprintf(L"LoadLibrary failed with %lu\n", GetLastError());
        return;
    }

    if (!FormatMessage(FORMAT_MESSAGE_FROM_HMODULE |
                       FORMAT_MESSAGE_ALLOCATE_BUFFER |
                       FORMAT_MESSAGE_IGNORE_INSERTS,
                       hPdhLibrary,
                       dwErrorCode,
                       0,
                       (LPWSTR)&pMessage,
                       0,
                       NULL))
    {
        wprintf(L"Format message failed with 0x%x\n", GetLastError());
        return;
    }

    wprintf(L"Formatted message: %ls\n", pMessage);
    LocalFree(pMessage);
}

对于数据收集和格式设置函数，请务必记住，函数的返回值指示函数调用的成功或错误，不一定是计数器数据的成功或错误。 始终检查返回的计数器值的 CStatus 成员，以确保返回的数据在使用前有效。 如果 CStatus 成员的值不指示成功，请不要使用数据。

下表提供了特定于 PDH 的错误代码列表。 这些值在 pdhmsg.h 头文件中定义。

错误代码 说明
0x00000000 (PDH_CSTATUS_VALID_DATA) 返回的数据有效。
0x00000001 (PDH_CSTATUS_NEW_DATA) 返回数据值有效，与上一个示例不同。
0x800007D0 (PDH_CSTATUS_NO_MACHINE) 无法连接到指定的计算机，或者计算机处于脱机状态。
0x800007D1 (PDH_CSTATUS_NO_INSTANCE) 指定的实例不存在。
0x800007D2 (PDH_MORE_DATA) 要返回的数据比提供的缓冲区中容纳的数据要多。 分配更大的缓冲区，然后再次调用函数。
0x800007D3 (PDH_CSTATUS_ITEM_NOT_VALIDATED) 数据项已添加到查询，但尚未验证或访问。 此数据项没有其他状态信息可用。
0x800007D4 (PDH_RETRY) 应重试所选操作。
0x800007D5 (PDH_NO_DATA) 没有要返回的数据。
0x800007D6 (PDH_CALC_NEGATIVE_DENOMINATOR) 检测到具有负分母值的计数器。
0x800007D7 (PDH_CALC_NEGATIVE_TIMEBASE) 检测到具有负时基值的计数器。
0x800007D8 (PDH_CALC_NEGATIVE_VALUE) 检测到具有负值的计数器。
0x800007D9 (PDH_DIALOG_CANCELLED) 用户取消了对话框。
0x800007DA (PDH_END_OF_LOG_FILE) 已到达日志文件的末尾。
0x800007DB (PDH_ASYNC_QUERY_TIMEOUT) 等待异步计数器收集线程结束时发生超时。
0x800007DC (PDH_CANNOT_SET_DEFAULT_REALTIME_DATASOURCE) 无法更改设置的默认实时数据源。 有收集计数器数据的实时查询会话。
0xC0000BB8 (PDH_CSTATUS_NO_OBJECT) 在系统上找不到指定的 对象。
0xC0000BB9 (PDH_CSTATUS_NO_COUNTER) 找不到指定的计数器。
0xC0000BBA (PDH_CSTATUS_INVALID_DATA) 返回的数据无效。
0xC0000BBB (PDH_MEMORY_ALLOCATION_FAILURE) PDH 函数无法分配足够的临时内存来完成操作。 关闭某些应用程序或扩展页面文件，然后重试函数。
0xC0000BBC (PDH_INVALID_HANDLE) 句柄不是有效的 PDH 对象。
0xC0000BBD (PDH_INVALID_ARGUMENT) 必需的参数丢失或不正确。
0xC0000BBE (PDH_FUNCTION_NOT_FOUND) 找不到指定的函数。
0xC0000BBF (PDH_CSTATUS_NO_COUNTERNAME) 未指定计数器。
0xC0000BC0 (PDH_CSTATUS_BAD_COUNTERNAME) 无法分析计数器路径。 检查指定路径的格式和语法。
0xC0000BC1 (PDH_INVALID_BUFFER) 调用方传递的缓冲区无效。
0xC0000BC2 (PDH_INSUFFICIENT_BUFFER) 请求的数据大于提供的缓冲区。 无法返回请求的数据。
0xC0000BC3 (PDH_CANNOT_CONNECT_MACHINE) 无法连接到请求的计算机。
0xC0000BC4 (PDH_INVALID_PATH) 无法解释指定的计数器路径。
0xC0000BC5 (PDH_INVALID_INSTANCE) 无法从指定的计数器路径读取实例名称。
0xC0000BC6 (PDH_INVALID_DATA) 数据无效。
0xC0000BC7 (PDH_NO_DIALOG_DATA) 对话框数据块缺失或无效。
0xC0000BC8 (PDH_CANNOT_READ_NAME_STRINGS) 无法从指定计算机读取计数器和/或帮助文本。
0xC0000BC9 (PDH_LOG_FILE_CREATE_ERROR) 无法创建指定的日志文件。
0xC0000BCA (PDH_LOG_FILE_OPEN_ERROR) 无法打开指定的日志文件。
0xC0000BCB (PDH_LOG_TYPE_NOT_FOUND) 此系统上尚未安装指定的日志文件类型。
0xC0000BCC (PDH_NO_MORE_DATA) 没有更多可用数据。
0xC0000BCD (PDH_ENTRY_NOT_IN_LOG_FILE) 在日志文件中找不到指定的记录。
0xC0000BCE (PDH_DATA_SOURCE_IS_LOG_FILE) 指定的数据源是日志文件。
0xC0000BCF (PDH_DATA_SOURCE_IS_REAL_TIME) 指定的数据源是当前活动。
0xC0000BD0 (PDH_UNABLE_READ_LOG_HEADER) 无法读取日志文件头。
0xC0000BD1 (PDH_FILE_NOT_FOUND) 找不到指定的文件。
0xC0000BD2 (PDH_FILE_ALREADY_EXISTS) 已有一个具有指定文件名的文件。
0xC0000BD3 (PDH_NOT_IMPLEMENTED) 引用的函数尚未实现。
0xC0000BD4 (PDH_STRING_NOT_FOUND) 在性能名称和帮助文本字符串列表中找不到指定的字符串。
0x80000BD5 (PDH_UNABLE_MAP_NAME_FILES) 无法映射到性能计数器名称数据文件。 数据将从注册表中读取并存储在本地。
0xC0000BD6 (PDH_UNKNOWN_LOG_FORMAT) PDH DLL 无法识别指定日志文件的格式。
0xC0000BD7 (PDH_UNKNOWN_LOGSVC_COMMAND) 无法识别指定的日志服务命令值。
0xC0000BD8 (PDH_LOGSVC_QUERY_NOT_FOUND) 无法找到或无法打开来自日志服务的指定查询。
0xC0000BD9 (PDH_LOGSVC_NOT_OPENED) 无法打开性能数据日志服务密钥。 这可能是由于权限不足或尚未安装服务。
0xC0000BDA (PDH_WBEM_ERROR) 访问 WBEM 数据存储时出错。
0xC0000BDB (PDH_ACCESS_DENIED) 无法访问所需的计算机或服务。 检查日志服务或交互式用户会话的权限和身份验证，以对照受监视的计算机或服务。
0xC0000BDC (PDH_LOG_FILE_TOO_SMALL) 指定的最大日志文件大小太小，无法记录所选计数器。 此日志文件中不会记录任何数据。 指定要记录的较小计数器集或更大的文件大小，然后重试此调用。
0xC0000BDD (PDH_INVALID_DATASOURCE) 无法连接到 ODBC DataSource 名称。
0xC0000BDE (PDH_INVALID_SQLDB) SQL 数据库不包含一组有效的 Perfmon 表。
0xC0000BDF (PDH_NO_COUNTERS) 找不到此 Perfmon SQL 日志集的计数器。
0xC0000BE0 (PDH_SQL_ALLOC_FAILED) 对 SQLAllocStmt 的调用失败，出现 %1。
0xC0000BE1 (PDH_SQL_ALLOCCON_FAILED) 调用 SQLAllocConnect 失败，出现 %1。
0xC0000BE2 (PDH_SQL_EXEC_DIRECT_FAILED) 调用 SQLExecDirect 失败，出现 %1。
0xC0000BE3 (PDH_SQL_FETCH_FAILED) 对 SQLFetch 的调用失败，出现 %1。
0xC0000BE4 (PDH_SQL_ROWCOUNT_FAILED) 调用 SQLRowCount 失败，出现 %1。
0xC0000BE5 (PDH_SQL_MORE_RESULTS_FAILED) 调用 SQLMoreResults 失败，出现 %1。
0xC0000BE6 (PDH_SQL_CONNECT_FAILED) 调用 SQLConnect 失败，出现 %1。
0xC0000BE7 (PDH_SQL_BIND_FAILED) 调用 SQLBindCol 失败，出现 %1。
0xC0000BE8 (PDH_CANNOT_CONNECT_WMI_SERVER) 无法连接到所请求计算机上的 WMI 服务器。
0xC0000BE9 (PDH_PLA_COLLECTION_ALREADY_RUNNING) 集合“%1！s！” 已在运行。
0xC0000BEA (PDH_PLA_ERROR_SCHEDULE_OVERLAP) 指定的开始时间晚于结束时间。
0xC0000BEB (PDH_PLA_COLLECTION_NOT_FOUND) 集合“%1！s！”不存在。
0xC0000BEC (PDH_PLA_ERROR_SCHEDULE_ELAPSED) 指定的结束时间已过。
0xC0000BED (PDH_PLA_ERROR_NOSTART) 集合“%1！s！”未启动;检查应用程序事件日志中是否存在任何错误。
0xC0000BEE (PDH_PLA_ERROR_ALREADY_EXISTS) 集合“%1！s！”已存在。
0xC0000BEF (PDH_PLA_ERROR_TYPE_MISMATCH) 设置类型不匹配。
0xC0000BF0 (PDH_PLA_ERROR_FILEPATH) 指定的信息不会解析为有效的路径名称。
0xC0000BF1 (PDH_PLA_SERVICE_ERROR) “性能日志 & 警报”服务没有响应。
0xC0000BF2 (PDH_PLA_VALIDATION_ERROR) 传递的信息无效。
0x80000BF3 (PDH_PLA_VALIDATION_WARNING) 传递的信息无效。
0xC0000BF4 (PDH_PLA_ERROR_NAME_TOO_LONG) 提供的名称太长。
0xC0000BF5 (PDH_INVALID_SQL_LOG_FORMAT) SQL 日志格式不正确。 正确的格式为 SQL:<DSN-name>!<LogSet-Name>。
0xC0000BF6 (PDH_COUNTER_ALREADY_IN_QUERY) PdhAddCounter 调用中的性能计数器已添加到性能查询中。 忽略此计数器。
0xC0000BF7 (PDH_BINARY_LOG_CORRUPT) 无法从输入的二进制日志文件读取计数器信息和数据。
0xC0000BF8 (PDH_LOG_SAMPLE_TOO_SMALL) 至少有一个输入二进制日志文件包含少于两个数据样本。
0xC0000BF9 (PDH_OS_LATER_VERSION) 名为 %1 的计算机上的操作系统版本晚于本地计算机上的版本。 此操作在本地计算机上不可用。
0xC0000BFA (PDH_OS_EARLIER_VERSION) %1 支持 %2 或更高版本。 检查名为 %3 的计算机上的操作系统版本。
0xC0000BFB (PDH_INCORRECT_APPEND_TIME) 输出文件必须包含早于要追加的文件的数据。
0xC0000BFC (PDH_UNMATCHED_APPEND_COUNTER) 两个文件必须具有相同的计数器才能追加。
0xC0000BFD (PDH_SQL_ALTER_DETAIL_FAILED) 无法更改 SQL 数据库中的 CounterDetail 表布局。
0xC0000BFE (PDH_QUERY_PERF_DATA_TIMEOUT) 系统正忙。 收集计数器数据时发生超时。 请稍后重试或增加 CollectTime 注册表值。