GetPrintProcessorDirectory-Funktion

Artikel
06/12/2023

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 NULL-Zeichenfolge, die den Namen des Servers angibt. Wenn dieser Parameter NULL ist, wird ein lokaler Pfad zurückgegeben.
pEnvironment [in]: Ein Zeiger auf eine NULL-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 Druckservers) 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 für Betriebssysteme vor Windows Server 2003 SP 1 der Pfad 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, selbst wenn für einen Remoteserver aufgerufen wird. Für die Betriebssysteme Windows Server 2003 SP 1 und höher wird der wahre Remotepfad zurückgegeben.
cbBuf [in]: Die Größe des Puffers, auf den pPrintProcessorInfo verweist.
pcbNeeded [ out]: Ein Zeiger auf einen Wert, der die Anzahl der kopierten Bytes angibt, wenn die Funktion erfolgreich ist, oder die Anzahl der erforderlichen Bytes, wenn cbBuf zu klein ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

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

Bemerkungen

Hinweis

Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierungsfaktoren ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.

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 (einschließlich Windows.h)
Bibliothek	Winspool.lib
DLL	Winspool.drv
Unicode- und ANSI-Name	GetPrintProcessorDirectoryW (Unicode) und GetPrintProcessorDirectoryA (ANSI)

Siehe auch

Drucken
Druckspooler-API-Funktionen
AddPrintProcessor

Freigeben über