pdhValidatePathExW 函式 (pdh.h)

驗證指定的計數器是否存在在計算機上或記錄檔中。

語法

PDH_FUNCTION PdhValidatePathExW(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCWSTR  szFullPathBuffer
);

[in, optional] hDataSource

數據源的句柄。 PdhOpenLog 和 PdhBindInputDataSource 函式會傳回此句柄。

若要驗證計數器是否存在於本機計算機上，請指定 NULL (這與呼叫 PdhValidatePath) 相同。

[in] szFullPathBuffer

以 Null 結束的字串，指定要驗證的計數器路徑。計數器路徑的最大長度是PDH_MAX_COUNTER_PATH。

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

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

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