EnumPrintProcessors-Funktion

Die EnumPrintProcessors-Funktion aufzählt die Druckprozessoren, die auf dem angegebenen Server installiert sind.

Syntax

BOOL EnumPrintProcessors(
  _In_  LPTSTR  pName,
  _In_  LPTSTR  pEnvironment,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pPrintProcessorInfo,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded,
  _Out_ LPDWORD pcReturned
);

Parameter

pName [ In]

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Namen des Servers angibt, auf dem sich die Druckprozessoren befinden. Wenn dieser Parameter NULL ist, werden die lokalen Druckprozessoren aufzählt.

pUmgebung [ In]

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die die Umgebung angibt (z. B. Windows x86, Windows IA64 oder Windows x64). Wenn dieser Parameter NULL ist, wird die aktuelle Umgebung der aufrufenden Anwendung und des Clientcomputers (nicht der Zielanwendung und des Druckerservers) verwendet.

Ebene [ In]

Der Typ der im pPrintProcessorInfo-Puffer zurückgegebenen Informationen. Dieser Parameter muss 1 sein.

pPrintProcessorInfo [ out]

Ein Zeiger auf einen Puffer, der ein Array von PRINTPROCESSOR _ INFO _ 1-Strukturen empfängt. Jede -Struktur beschreibt einen verfügbaren Druckprozessor. Der Puffer muss groß genug sein, um das Array von Strukturen und alle Zeichenfolgen zu empfangen, auf die die Strukturmitglieder zeigen.

Um die erforderliche Puffergröße zu bestimmen, rufen Sie EnumPrintProcessors mit cbBuf auf 0 (null) auf. Bei EnumPrintProcessors tritt ein Fehler auf, GetLastError gibt ERROR INSUFFICIENT BUFFER zurück, und der _ parameter _ "arraysNeeded" gibt die Größe des Puffers in Bytes zurück, der zum Speichern des Arrays von Strukturen und deren Daten erforderlich ist.

cbBuf [ In]

Die Größe des Puffers in Bytes, auf den pPrintProcessorInfo zeigt.

-Needed [ out]

Ein Zeiger auf eine Variable, die die Anzahl der in den pPrintProcessorInfo-Puffer kopierten Bytes empfängt, wenn die Funktion erfolgreich ist. Wenn der Puffer zu klein ist, schlägt die Funktion fehl, und die Variable empfängt die erforderliche Anzahl von Bytes.

pcReturned [ out]

Ein Zeiger auf eine Variable, die die Anzahl der im pPrintProcessorInfo-Puffer zurückgegebenen Strukturen empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich 0 (null).

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Hinweis

Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückkehrt. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren des Druckertreibers ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu kommen, dass die Anwendung nicht reagiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Winspool.h (include Windows.h)
Bibliothek
Winspool.lib
DLL
Winspool.drv
Unicode- und ANSI-Name
EnumPrintProcessorsW (Unicode) und EnumPrintProcessorsA (ANSI)

Weitere Informationen

Drucken

Druckspooler-API-Funktionen

AddPrintProcessor

EnumPrintProcessorDatatypes

PRINTPROCESSOR _ INFO _ 1