PdhBindInputDataSourceA 函式 (pdh.h)

將一或多個二進位記錄檔系結在一起，以讀取記錄數據。

語法

PDH_FUNCTION PdhBindInputDataSourceA(
  [out] PDH_HLOG *phDataSource,
  [in]  LPCSTR   LogFileNameList
);

[out] phDataSource

系結數據源的句柄。

[in] LogFileNameList

Null 終止的字串，其中包含一或多個要系結的二進位記錄檔。使用 null 終止符終止每個記錄檔名稱，並使用一個額外的 Null 終止符來終止清單。記錄檔名稱可以包含絕對路徑或相對路徑。您無法指定超過 32 個記錄檔。

如果 為 NULL，則來源是實時數據源。

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

如果函式失敗，傳回值為系統錯誤碼或 PDH 錯誤碼。

此函式會與需要數據源句柄的 PDH 函式搭配使用。如需這些函式的清單，請參閱另請參閱。

您無法指定多個逗號分隔 (CSV) 或以製表符分隔 (TSV) 檔案。此清單只能包含一種類型的檔案—您無法合併多個檔案類型。

若要關閉系結的記錄檔，請使用記錄句柄呼叫 PdhCloseLog 函式。

注意

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