PdhValidatePathA 函式（pdh.h）

驗證計數器是否存在於計數器路徑中指定的計算機上。

語法

PDH_FUNCTION PdhValidatePathA(
  [in] LPCSTR szFullPathBuffer
);

[in] szFullPathBuffer

包含要驗證之計數器路徑的 Null 終止字串。計數器路徑的最大長度為 PDH_MAX_COUNTER_PATH。

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

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

傳回碼	描述
PDH_CSTATUS_NO_INSTANCE	找不到性能物件的指定實例。
PDH_CSTATUS_NO_COUNTER	性能物件中找不到指定的計數器。
PDH_CSTATUS_NO_OBJECT	計算機上找不到指定的效能物件。
PDH_CSTATUS_NO_MACHINE	找不到或連線到指定的電腦。
PDH_CSTATUS_BAD_COUNTERNAME	無法剖析計數器路徑字串。
PDH_MEMORY_ALLOCATION_FAILURE	函式無法配置必要的暫存緩衝區。

注意

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