FaxGetLoggingCategoriesW 函式（winfax.h）

FaxGetLoggingCategories 函式會傳回傳真用戶端應用程式目前用戶端所連接的傳真伺服器記錄類別。記錄類別會決定應用程式事件記錄檔中傳真伺服器記錄的錯誤或其他事件。

語法

WINFAXAPI BOOL FaxGetLoggingCategoriesW(
  [in]  HANDLE             FaxHandle,
  [out] PFAX_LOG_CATEGORYW *Categories,
  [out] LPDWORD            NumberCategories
);

參數

[in] FaxHandle

類型：HANDLE

指定由呼叫 FaxConnectFaxServer 函式所傳回的傳真伺服器句柄。

[out] Categories

類型：PFAX_LOG_CATEGORY*

要接收 FAX_LOG_CATEGORY 結構陣列之緩衝區位址的指標。每個結構都會描述一個目前的記錄類別。數據報含記錄類別的描述性名稱、類別編號，以及目前的記錄層級。

如需預先定義記錄類別和記錄層級的描述，請參閱 FAX_LOG_CATEGORY 主題。如需記憶體配置的相關信息，請參閱下列一節。

[out] NumberCategories

類型：LPDWORD

DWORD 變數的指標，以接收函式在 Categories 參數中傳回的 FAX_LOG_CATEGORY 結構數目。

傳回值

類型：BOOL

如果函式成功，則傳回值為非零值。

如果函式失敗，傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。 GetLastError 可以傳回下列其中一個錯誤。

傳回碼	描述
ERROR_ACCESS_DENIED	拒絕存取。需要 FAX_CONFIG_QUERY 存取權。
ERROR_INVALID_PARAMETER	一或所有類別、NumberCategories或 FaxHandle 參數都會 NULL。
ERROR_NOT_ENOUGH_MEMORY	記憶體配置期間發生錯誤。

言論

傳真用戶端應用程式通常會呼叫 FaxGetLoggingCategories 函式來查詢傳真伺服器的目前記錄類別和記錄層級。若要修改目前的記錄類別和層級，請呼叫 FaxSetLoggingCategories 函式。

FaxGetLoggingCategories 函式會設定 Categories 參數所指向之 FAX_LOG_CATEGORY 緩衝區陣列所需的記憶體。應用程式必須呼叫 FaxFreeBuffer 函式，以解除分配與此參數相關聯的資源。

如需詳細資訊，請參閱管理記錄類別和釋放傳真資源。

注意

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

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winfax.h
連結庫	WinFax.lib