PdhConnectMachineW 函数 (pdh.h)

连接到指定的计算机。

语法

PDH_FUNCTION PdhConnectMachineW(
  [in] LPCWSTR szMachineName
);

[in] szMachineName

以 Null 结尾的字符串，指定要连接到的计算机的名称。如果 为 NULL，则 PDH 连接到本地计算机。

如果函数成功，则返回ERROR_SUCCESS。

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

返回代码	说明
PDH_CSTATUS_NO_MACHINE	无法连接到指定的计算机。可能是由于计算机未打开、不支持 PDH、未连接到网络，或在注册表上设置了阻止远程连接或远程性能监视的权限。
PDH_MEMORY_ALLOCATION_FAILURE	无法分配动态内存块。当系统中由于运行的应用程序过多或内存分页文件不足而严重内存不足时发生。

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

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

注意

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