Syntax:

INT LlGetPrinterFromPrinterFile (HLLJOB hJob, UINT nObjType, LPCTSTR pszObjName, INT nPrinter, LPTSTR pszPrinter, LLPUINT pnSizePrn, _PDEVMODE pDM, LLPUINT pnSizeDm);

Aufgabe:

Ermöglicht es, die Druckerkonfiguration aus der Druckerbeschreibungsdatei zu lesen.

Parameter:

hJob: List & Label-Job-Handle

nObjType: LL_­PROJECT_­LABEL, LL_­PROJECT_­LIST oder LL_­PROJECT_­CARD

pszObjName: Dateiname des Projekts mit Dateiendung

nPrinter: Druckerindex (0 für Erstseiten-Drucker, 1 für Folgeseiten-Drucker) Wenn Sie Werte ab 100 übergeben (bspw. in einer Schleife solange bis Sie LL_ERR_PARAMETER als Rückgabewert bekommen), können Sie damit den Drucker für die Layout-Bereiche (in der Reihenfolge wie sie unter Projekt > Seitenlayout hinzugefügt wurden) abfragen. Sollte das Projekt nur einen Drucker enthalten muss nPrinter den Wert -1 erhalten.

pszPrinter: Zeiger auf einen Puffer, in den der Druckername gespeichert werden soll. Wenn pszPrinter NULL ist und pnSizePrn nicht NULL ist, wird die Größe des benötigten Platzes in *pnSizePrn gespeichert.

pnSizePrn: Puffergröße des Bereichs, auf den pszPrinter zeigt (Größe in Zeichen, also muss bei der Unicode-API die doppelte Anzahl in Bytes reserviert werden).

pDM: Zeiger auf einen Puffer, in dem die DEVMODE-Struktur des Druckers abgelegt wird. Wenn pDM NULL ist und pnSizeDm nicht NULL ist, wird die Größe des benötigten Platzes in *pnSizeDm gespeichert.

pnSizeDm: Puffergröße des Bereichs, auf den pDM zeigt.

Rückgabewert:

Fehlercode

Hinweise:

Die DEVMODE-Struktur ist in der Windows-API definiert.

Durch die Möglichkeit unterschiedliche Druck-Bereiche im Designer definieren zu können, ist die praktische Nutzbarkeit dieser Funktion sehr stark eingeschränkt. Wir empfehlen daher, über das LL-Objektmodell gemäß Kapitel Verwendung der DOM-API (ab Professional Edition) auf die Bereiche und die dort eingestellten Drucker zuzugreifen.

Bezüglich des Rückgabewerts im Puffer siehe Kapitel Wichtiges zu den Funktionsparametern.

Siehe auch:

LlSetPrinterInPrinterFile