PdhConnectMachineA 函数（pdh.h）

连接到指定的计算机。

语法

PDH_FUNCTION PdhConnectMachineA(
  [in] LPCSTR szMachineName
);

[in] szMachineName

Null-terminated 字符串，指定要连接到的计算机的名称。如果 NULL，PDH 将连接到本地计算机。

如果函数成功，它将返回ERROR_SUCCESS。

如果函数失败，则返回值为系统错误代码或 PDH 错误代码。以下是可能的值。

返回代码	描述
PDH_CSTATUS_NO_MACHINE	无法连接到指定的计算机。可能是由于计算机未打开、不支持 PDH、未连接到网络或对注册表设置了权限，从而阻止用户进行远程连接或远程性能监视。
PDH_MEMORY_ALLOCATION_FAILURE	无法分配动态内存块。由于系统上运行的应用程序过多或内存分页文件不足，系统中出现严重内存短缺的情况。

通常，应用程序不调用此函数，而是在应用程序将计数器添加到查询时建立连接。

但是，如果要在 “浏览计数器”对话框中 列表中选择计算机中的本地计算机多，则可以使用此函数。有关详细信息，请参阅 PDH_BROWSE_DLG_CONFIG 结构。

注意

pdh.h 标头将 PdhConnectMachine 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。