pdhConnectMachineA 函式 (pdh.h)

連接到指定的電腦。

語法

PDH_FUNCTION PdhConnectMachineA(
  [in] LPCSTR szMachineName
);

[in] szMachineName

以 Null 結束的字串，指定要連線的電腦名稱。如果 為 NULL，PDH 會連線到本機電腦。

如果函式成功，則會傳回ERROR_SUCCESS。

如果函式失敗，傳回值為系統錯誤碼或 PDH 錯誤碼。以下是可能的值。

傳回碼	Description
PDH_CSTATUS_NO_MACHINE	無法連線到指定的電腦。可能是因為電腦未開啟、不支援 PDH、未連線到網路，或在登錄上設定許可權，以防止使用者遠端連線或遠端效能監視所造成。
PDH_MEMORY_ALLOCATION_FAILURE	無法配置易失記憶體區塊。發生於系統中因為系統上執行太多應用程式或記憶體分頁檔案不足而發生嚴重記憶體不足的情況。

一般而言，應用程式不會呼叫此函式，而是在應用程式將計數器新增至查詢時建立連接。

不過，如果您想要在 [瀏覽計數器] 對話方塊的 [從計算機選取計數器] 清單中包含更多本機計算機，則可以使用此函式。如需詳細資訊，請參閱 PDH_BROWSE_DLG_CONFIG 結構。

注意

pdh.h 標頭會將 PdhConnectMachine 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。