PdhOpenLogW 函式 （pdh.h）
開啟指定的記錄檔以供讀取或寫入。
語法
PDH_FUNCTION PdhOpenLogW(
[in] LPCWSTR szLogFileName,
[in] DWORD dwAccessFlags,
[in] LPDWORD lpdwLogType,
[in] PDH_HQUERY hQuery,
[in] DWORD dwMaxSize,
[in] LPCWSTR szUserCaption,
[out] PDH_HLOG *phLog
);
參數
[in] szLogFileName
Null-terminated 字串，指定要開啟的記錄檔名稱。 名稱可以包含絕對路徑或相對路徑。
如果 lpdwLogType 參數為 PDH_LOG_TYPE_SQL，請指定表單中的記錄檔名稱，SQL：DataSourceName！LogFileName。
[in] dwAccessFlags
用來開啟記錄檔的存取類型。 指定下列其中一個值。
| 價值 | 意義 |
|---|---|
|
開啟記錄檔以供讀取。 |
|
開啟新的記錄檔以進行寫入。 |
|
開啟現有的記錄檔以進行寫入。 |
您可以使用位內含 OR 運算符 （|） 來結合存取類型與下列一或多個建立旗標。
| 價值 | 意義 |
|---|---|
|
建立具有指定名稱的新記錄檔。 |
|
建立具有指定名稱的新記錄檔。 如果記錄檔已經存在，函式會先移除現有的記錄檔，再建立新的檔案。 |
|
開啟具有指定名稱的現有記錄檔。 如果具有指定名稱的記錄檔不存在，這等於PDH_LOG_CREATE_NEW。 |
|
開啟具有指定名稱的現有記錄檔，或建立具有指定名稱的新記錄檔。 |
|
建立具有指定名稱的循環記錄檔。 當檔案到達 dwMaxSize 參數的值時，數據會包裝至記錄檔的開頭。 只有當 lpdwLogType 參數 PDH_LOG_TYPE_BINARY時，才能指定這個旗標。 |
|
與 PDH_LOG_TYPE_TSV 搭配使用，以寫入 PdhUpdateLog 或 PdhOpenLogszUserString 參數所指出的用戶標題或記錄檔描述。 用戶標題或記錄檔描述會寫入為文字記錄第一行的最後一欄。 |
[in] lpdwLogType
要開啟的記錄檔類型。 此參數可以是下列其中一個值。
[in] hQuery
如果您要將查詢數據寫入記錄檔，請指定查詢句柄。 PdhOpenQuery 函式會傳回此句柄。
如果您從記錄檔讀取，此參數會被忽略，而且應該 NULL。
[in] dwMaxSize
記錄檔的大小上限，以位元組為單位。 如果您想要限制檔案大小，或 dwAccessFlags 指定 PDH_LOG_OPT_CIRCULAR，請指定大小上限;否則，請將 設定為 0。
針對循環記錄檔，您必須指定足以保存至少一個範例的值。 樣本大小取決於收集的數據。 不過，指定至少一 MB 的值將涵蓋大部分的範例。
[in] szUserCaption
Null-terminated 字串，指定記錄檔的使用者定義標題。 記錄檔標題通常描述記錄檔的內容。 開啟現有的記錄檔時，會忽略此參數的值。
[out] phLog
已開啟記錄檔的句柄。
傳回值
如果函式成功，則會傳回ERROR_SUCCESS。
言論
若要使用此函式將效能數據寫入記錄檔，您必須先使用 PdhOpenQuery 開啟查詢，並將所需的計數器加入其中，再呼叫此函式。
較新的作業系統可以讀取舊版操作系統上產生的記錄檔;不過，在 Windows Vista 和更新版本的作業系統上建立的記錄檔無法在舊版作業系統上讀取。
下列規則適用於記錄檔
READ_ACCESS需要OPEN_EXISTING。
UPDATE_ACCESS無法與檔案型記錄搭配使用。 它只能與資料庫記錄搭配使用。
WRITE_ACCESS需要其中一個CREATE_NEW、CREATE_ALWAYS、OPEN_EXISTING、OPEN_ALWAYS。
例子
如需範例，請參閱 將效能數據寫入記錄檔。
注意
pdh.h 標頭會將 PdhOpenLog 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | pdh.h |
| 連結庫 | Pdh.lib |
| DLL | Pdh.dll |