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 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。