PdhConnectMachineW 函式 (pdh.h)

連接到指定的電腦。

語法

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