pdhConnectMachineA 函数 (pdh.h)
连接到指定的计算机。
语法
PDH_FUNCTION PdhConnectMachineA(
[in] LPCSTR szMachineName
);
参数
[in] szMachineName
以 Null 结尾的字符串,指定要连接到的计算机的名称。 如果 为 NULL,则 PDH 连接到本地计算机。
返回值
如果函数成功,则返回ERROR_SUCCESS。
如果函数失败,则返回值为 系统错误代码 或 PDH 错误代码。 以下是可能的值。
返回代码 | 说明 |
---|---|
|
无法连接到指定的计算机。 可能是由于计算机未打开、不支持 PDH、未连接到网络,或者在注册表上设置了阻止用户进行远程连接或远程性能监视的权限。 |
|
无法分配动态内存块。 由于系统上运行的应用程序过多或内存分页文件不足而导致系统中内存严重不足时发生。 |
注解
通常,应用程序不会调用此函数,而是在应用程序将计数器添加到查询时建立连接。
但是,如果要在“浏览计数器”对话框的“从计算机中选择计数器”列表中包含的计数器数超过本地计算机,则可以使用此函数。 有关详细信息,请参阅 PDH_BROWSE_DLG_CONFIG 结构。
注意
pdh.h 标头将 PdhConnectMachine 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | pdh.h |
Library | Pdh.lib |
DLL | Pdh.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈