GetPrintProcessorDirectory-Funktion

Die GetPrintProcessorDirectory-Funktion ruft den Pfad zum Druckprozessorverzeichnis auf dem angegebenen Server ab.

Syntax

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

Parameter

pName [ In]

Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Servers angibt. Wenn dieser Parameter NULL ist, wird ein lokaler Pfad zurückgegeben.

pEnvironment [ In]

Ein Zeiger auf eine auf NULL endende 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]

Die Strukturebene. Dieser Wert muss 1 sein.

pPrintProcessorInfo [ out]

Ein Zeiger auf einen Puffer, der den Pfad empfängt. Beachten Sie, dass der Pfad für Betriebssysteme vor Windows Server 2003 SP 1 im lokalen Format für den Server und nicht im echten Remoteformat vorliegt. Beispielsweise wird der Pfad als "%Windir% \ System32 \ Spool \ Prtprocs \ %Environment%" anstelle von \ \ "ServerName \ Print$ \ Prtprocs \ %Environment%" angegeben, auch wenn er für einen Remoteserver aufgerufen wird. Für die Betriebssysteme Windows Server 2003 SP 1 und höher wird der echte Remotepfad zurückgegeben.

cbBuf [ In]

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

"Needed" [ out]

Ein Zeiger auf einen Wert, der die Anzahl der kopierten Bytes angibt, wenn die Funktion erfolgreich ausgeführt wird, oder die Anzahl der Bytes, die erforderlich sind, wenn cbBuf zu klein ist.

Rückgabewert

Wenn die Funktion erfolgreich ausgeführt wird, 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 und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren für Druckertreiber ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion über einen Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, kann dazu bringen, dass die Anwendung scheinbar 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
GetPrintProcessorDirectoryW (Unicode) und GetPrintProcessorDirectoryA (ANSI)

Weitere Informationen

Drucken

Druckspooler-API-Funktionen

AddPrintProcessor