FAX_CONTEXT_INFOA-Struktur (winfax.h)

Artikel
03/04/2024

Die FAX_CONTEXT_INFO-Struktur enthält Informationen zu einem Faxdruckergerätekontext. Der SizeOfStruct-Member ist erforderlich. Informationen für die anderen Member werden durch einen Aufruf der FaxStartPrintJob-Funktion bereitgestellt.

Syntax

typedef struct _FAX_CONTEXT_INFOA {
  DWORD SizeOfStruct;
  HDC   hDC;
  CHAR  ServerName[MAX_COMPUTERNAME_LENGTH + 1];
} FAX_CONTEXT_INFOA, *PFAX_CONTEXT_INFOA;

Member

SizeOfStruct

Art: DWORD

Gibt die Größe der FAX_CONTEXT_INFO-Struktur in Bytes an. Die aufrufende Anwendung muss diesen Member auf sizeof(FAX_CONTEXT_INFO) festlegen, bevor die FaxStartPrintJob-Funktion aufgerufen wird.

hDC

Typ: HDC

Verarbeiten eines Faxdruckergerätekontexts. Ein Aufruf der FaxStartPrintJob-Funktion stellt die Daten für diesen Member bereit.

ServerName[MAX_COMPUTERNAME_LENGTH + 1]

Typ: TCHAR[MAX_COMPUTERNAME_LENGTH+1]

Gibt eine Variable an, die eine NULL-endende Zeichenfolge enthält, die den namen des faxservers von Interesse ist. Ein Aufruf der FaxStartPrintJob-Funktion stellt die Daten für diesen Member bereit. Wenn sich der Faxserver auf dem lokalen Computer befindet, ist dieser Member leer. Die Clientanwendung muss diesen Member nicht ausfüllen.

Hinweise

Eine Faxclientanwendung kann die FaxStartPrintJob-Funktion aufrufen, um das Handle in einen Faxdruckergerätekontext abzurufen. Die Funktion gibt das Handle in einer FAX_CONTEXT_INFO-Struktur zurück. Die Anwendung muss die DeleteDC-Funktion aufrufen, um die Zuordnung des Handles zum Kontext des Druckergeräts zu aufheben. Weitere Informationen finden Sie unter Drucken eines Faxs an einen Gerätekontext.

Hinweis

Der winfax.h-Header definiert FAX_CONTEXT_INFO 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