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 |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
GetPrintProcessorDirectoryW (Unicode) und GetPrintProcessorDirectoryA (ANSI) |