FaxSetLoggingCategoriesA-Funktion (winfax.h)

Eine Faxclientanwendung ruft die FaxSetLoggingCategories Funktion auf, um die aktuellen Protokollierungskategorien für den Faxserver zu ändern, mit dem der Client verbunden ist. Eine Protokollierungskategorie bestimmt die Fehler oder andere Ereignisse, die der Faxserver im Anwendungsereignisprotokoll aufzeichnet.

Syntax

WINFAXAPI BOOL FaxSetLoggingCategoriesA(
  [in] HANDLE                  FaxHandle,
  [in] const FAX_LOG_CATEGORYA *Categories,
  [in] DWORD                   NumberCategories
);

Parameter

[in] FaxHandle

Typ: HANDLE

Gibt ein Faxserverhandle an, das von einem Aufruf der FaxConnectFaxServer--Funktion zurückgegeben wird.

[in] Categories

Typ: FAX_LOG_CATEGORY*

Zeiger auf ein Array von FAX_LOG_CATEGORY Strukturen. Jede Struktur enthält die Daten zum Ändern einer Protokollierungskategorie. Die Daten enthalten den beschreibenden Namen der Protokollierungskategorie, die Kategorienummer und die aktuelle Protokollierungsebene für die Kategorie. Eine Beschreibung der vordefinierten Protokollierungskategorien und Protokollierungsebenen finden Sie im thema FAX_LOG_CATEGORY.

[in] NumberCategories

Typ: DWORD-

Gibt eine DWORD- Variable an, die die Anzahl der FAX_LOG_CATEGORY Strukturen enthält, die die Funktion im Categories Parameter übergibt.

Rückgabewert

Typ: BOOL-

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. GetLastError kann einen der folgenden Fehler zurückgeben.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Mindestens einer der parameter FaxHandle, Categoriesoder NumberCategories Parameter sind ungültig oder NULL.
ERROR_INVALID_PARAMETER	Der parameter FaxHandle ist NULL; oder der hWnd Parameter wird angegeben, der parameter FaxHandle gibt jedoch keine Verbindung mit einem lokalen Faxserver an; oder der parameter MessageStart gibt eine Nachricht im Bereich unter WM_USERan.
ERROR_ACCESS_DENIED	Der Zugriff wurde verweigert. FAX_CONFIG_SET Zugriff ist erforderlich.
ERROR_NOT_ENOUGH_MEMORY	Fehler bei der Speicherzuweisung.

Bemerkungen

Die Faxdienstverwaltungsanwendung, eine MMC-Snap-In-Komponente (Microsoft Management Console), ruft in der Regel die FaxSetLoggingCategories-Funktion auf, um die aktuellen Protokollierungskategorien und Protokollierungsebenen für einen Faxserver zu ändern. Um die Kategorien und Ebenen abzufragen, kann eine Anwendung die FaxGetLoggingCategories-Funktion aufrufen. Weitere Informationen finden Sie unter Verwalten von Protokollierungskategorien.

Anmerkung

Der winfax.h-Header definiert FaxSetLoggingCategories als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winfax.h
Library	WinFax.lib

Siehe auch

FAX_LOG_CATEGORY

Faxdienst-Client-API-Funktionen

Faxdienst-Client-API für Windows 2000-

FaxConnectFaxServer-

FaxGetLoggingCategories