FAX_CONFIGURATIONA-Struktur (winfax.h)
Die FAX_CONFIGURATION-Struktur enthält Informationen zu den globalen Konfigurationseinstellungen eines Faxservers. Die Struktur umfasst Daten zu Den Einstellungen für die Erneute Übertragung, das Branding, das Archiv und die Deckblatteinstellungen. Diskontierungszeiträume; und die status der Faxserverwarteschlange.
Syntax
typedef struct _FAX_CONFIGURATIONA {
DWORD SizeOfStruct;
DWORD Retries;
DWORD RetryDelay;
DWORD DirtyDays;
BOOL Branding;
BOOL UseDeviceTsid;
BOOL ServerCp;
BOOL PauseServerQueue;
FAX_TIME StartCheapTime;
FAX_TIME StopCheapTime;
BOOL ArchiveOutgoingFaxes;
LPCSTR ArchiveDirectory;
LPCSTR Reserved;
} FAX_CONFIGURATIONA, *PFAX_CONFIGURATIONA;
Member
SizeOfStruct
Art: DWORD
Gibt die Größe der FAX_CONFIGURATION-Struktur in Bytes an. Die aufrufende Anwendung muss diesen Member auf sizeof(FAX_CONFIGURATION) festlegen, bevor die FaxSetConfiguration-Funktion aufgerufen wird .
Retries
Art: DWORD
Gibt eine DWORD-Variable an, die angibt, wie oft der Faxserver versucht, ein ausgehendes Fax erneut zu übertragen, wenn die anfängliche Übertragung fehlschlägt.
RetryDelay
Art: DWORD
Gibt eine DWORD-Variable an, die die Anzahl der Minuten angibt, die zwischen den Wiederholungsversuchen durch den Faxserver vergehen.
DirtyDays
Art: DWORD
Gibt eine DWORD-Variable an, die angibt, wie viele Tage der Faxserver einen nicht gesendeten Auftrag in der Faxauftragswarteschlange beibehält. Eine Übertragung wird möglicherweise nicht gesendet, z. B. wenn eine ungültige Faxnummer oder ein ungültiges Datum angegeben ist oder wenn das sendenden Gerät mehrmals ein Ausgelastetes Signal empfängt.
Branding
Typ: BOOL
Gibt eine boolesche Variable an, die angibt, ob der Faxserver eine Marke (Banner) am Anfang der ausgehenden Faxübertragungen generieren soll. Wenn dieser Member TRUE ist, generiert der Faxserver eine Marke, die übertragungsbezogene Informationen wie den Bezeichner der Sendestation, Datum, Uhrzeit und Seitenanzahl enthält.
UseDeviceTsid
Typ: BOOL
Gibt eine boolesche Variable an, die angibt, ob der Faxserver anstelle des im Tsid-Member der FAX_JOB_PARAM-Struktur angegebenen Wert den Sendestationsbezeichner des Geräts verwendet. Wenn dieser Member TRUE ist, verwendet der Server den Senderbezeichner des Geräts.
ServerCp
Typ: BOOL
Gibt eine boolesche Variable an, die angibt, ob Faxclientanwendungen ein vom Benutzer entworfenes Deckblatt mit der Faxübertragung enthalten können. Wenn dieser Member TRUE ist, muss der Client ein allgemeines Deckblatt verwenden, das auf dem Faxserver gespeichert ist. Wenn dieser Member FALSE ist, kann der Client eine persönliche Deckblattdatei verwenden.
PauseServerQueue
Typ: BOOL
Gibt eine boolesche Variable an, die angibt, ob der Faxserver die Faxauftragswarteschlange angehalten hat. Wenn dieser Member TRUE ist, wurde die Warteschlange angehalten.
StartCheapTime
Typ: FAX_TIME
Gibt eine FAX_TIME-Struktur an, die die Stunde und Die Minute angibt, mit der der Rabattzeitraum beginnt. Der Rabattzeitraum gilt nur für ausgehende Übertragungen.
StopCheapTime
Typ: FAX_TIME
Gibt eine FAX_TIME-Struktur an, die die Stunde und die Minute angibt, mit der der Rabattzeitraum endet. Der Rabattzeitraum gilt nur für ausgehende Übertragungen.
ArchiveOutgoingFaxes
Typ: BOOL
Gibt eine boolesche Variable an, die angibt, ob der Faxserver ausgehende Faxübertragungen archivieren soll. Wenn dieser Member TRUE ist, archiviert der Server ausgehende Übertragungen in dem verzeichnis, das vom ArchiveDirectory-Element angegeben wird.
ArchiveDirectory
Typ: LPCTSTR
Zeiger auf eine konstante NULL-endende Zeichenfolge, die den vollqualifizierten Pfad des Verzeichnisses enthält, in dem ausgehende Faxübertragungen archiviert werden. Der Pfad kann ein UNC-Pfad oder ein Pfad sein, der mit einem Laufwerkbuchstaben beginnt. Der Faxserver ignoriert diesen Member, wenn das ArchiveOutgoingFaxes-ElementFALSE ist. Dieser Member kann NULL sein, wenn das ArchiveOutgoingFaxes-ElementFALSE ist.
Reserved
Hinweise
Die Faxclientanwendung übergibt die FAX_CONFIGURATION-Struktur in einem Aufruf der FaxSetConfiguration-Funktion , um die globalen Konfigurationseinstellungen für den relevanten Faxserver zu ändern. Wenn die Anwendung die FaxGetConfiguration-Funktion aufruft , gibt sie die aktuellen Einstellungen in einer FAX_CONFIGURATION-Struktur zurück. Weitere Informationen finden Sie unter Faxserver-Konfigurationsverwaltung.
Hinweis
Der winfax.h-Header definiert FAX_CONFIGURATION 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | winfax.h |
Weitere Informationen
Api-Strukturen des Faxdienstclients