Detlef Riekenberg : winspool: Documentation for GetPrintProcessorDirectory.

[Alexandre Julliard]

Module: wine
Branch: refs/heads/master
Commit: aff1b33192c2396599959cd3383118c91c22ed5f
URL:    http://source.winehq.org/git/?p=wine.git;a=commit;h=aff1b33192c2396599959cd3...

Author: Detlef Riekenberg 
Date:   Sat May 27 00:30:58 2006 +0200

winspool: Documentation for GetPrintProcessorDirectory.

---

dlls/winspool.drv/info.c |   35 +++++++++++++++++++++++++++++++++++
 1 files changed, 35 insertions(+), 0 deletions(-)

diff --git a/dlls/winspool.drv/info.c b/dlls/winspool.drv/info.c
index ed12be6..12bc975 100644
--- a/dlls/winspool.drv/info.c
+++ b/dlls/winspool.drv/info.c
@@ -1825,6 +1825,14 @@ end:

/*****************************************************************************
  *          GetPrintProcessorDirectoryA  [WINSPOOL.@]
+ *
+ * Return the PATH for the Print-Processors
+ *
+ * See GetPrintProcessorDirectoryW.
+ *
+ * NOTES
+ * On NT, the returned ANSI-Data need the same Size as the Unicode-Version
+ *
  */
 BOOL WINAPI GetPrintProcessorDirectoryA(LPSTR server, LPSTR env,
                                         DWORD level,  LPBYTE Info,
@@ -1837,6 +1845,33 @@ BOOL WINAPI GetPrintProcessorDirectoryA(

/*****************************************************************************
  *          GetPrintProcessorDirectoryW  [WINSPOOL.@]
+ *
+ * Return the PATH for the Print-Processors
+ *
+ * PARAMS
+ *   server     [I] Servername (NT only) or NULL (local Computer)
+ *   env        [I] Printing-Environment (see below) or NULL (Default)
+ *   level      [I] Structure-Level (must be 1)
+ *   Info       [O] PTR to Buffer that receives the Result
+ *   cbBuf      [I] Size of Buffer at "Info"
+ *   needed     [O] PTR to DWORD that receives the size in Bytes used / 
+ *                  required for the Buffer at "Info"
+ *
+ * RETURNS
+ *   Success: TRUE  and in pcbNeeded the Bytes used in pPrintProcessorInfo
+ *   Failure: FALSE and in pcbNeeded the Bytes required for pPrintProcessorInfo,
+ *   if cbBuf is too small
+ * 
+ *   Native Values returned in pPrintProcessorInfo on Success:
+ *|  NT(Windows NT x86):  "%winsysdir%\spool\PRTPROCS\w32x86" 
+ *|  NT(Windows 4.0):     "%winsysdir%\spool\PRTPROCS\win40" 
+ *|  win9x(Windows 4.0):  "%winsysdir%" 
+ *
+ *   "%winsysdir%" is the Value from GetSystemDirectoryW()
+ *
+ * BUGS
+ *-  Only NULL or "" is supported for pName
+ *
  */
 BOOL WINAPI GetPrintProcessorDirectoryW(LPWSTR server, LPWSTR env,
                                         DWORD level,  LPBYTE Info,