勇芳软件工作室.汉化:  Printing > Print Spooler API > Printer Driver Installation >

GetPrintProcessorDirectory

Previous pageReturn to chapter overviewNext page

描述

 

GetPrintProcessorDirectory功能检索指定服务器上打印处理器目录的路径。

 

C++ 语法

 

BOOL GetPrintProcessorDirectory(

__in  LPTSTR pName,

__in  LPTSTR pEnvironment,

__in  DWORD Level,

__out LPBYTE pPrintProcessorInfo,

__in  DWORD cbBuf,

__out LPDWORD pcbNeeded

);

 

PowerBASIC 语法

 

FUNCTION GetPrintProcessorDirectoryA ( _

BYREF pName AS ASCIIZ, _

BYREF pEnvironment AS ASCIIZ, _

BYVAL Level AS DWORD, _

BYREF pPrintProcessorInfo AS ANY, _

BYVAL cbBuf AS DWORD, _

BYREF pcbNeeded AS DWORD _

) AS LONG

 

Unicode版本:

 

FUNCTION GetPrintProcessorDirectoryW ( _

BYREF pName AS WSTRINGZ, _

BYREF pEnvironment AS WSTRINGZ, _

BYVAL Level AS DWORD, _

BYREF pPrintProcessorInfo AS ANY, _

BYVAL cbBuf AS DWORD, _

BYREF pcbNeeded AS DWORD _

) AS LONG

 

参数

 

pName

 

[in]指向指定服务器名称的以空值终止的字符串的指针。如果此参数为NULL,则返回本地路径。

 

pEnvironment

 

[in]指向指定环境的空终止字符串的指针(例如,Windows NT x86,Windows IA64,Windows x64,Windows NT R4000,Windows NT Alpha_AXP,Windows 4.0或Windows NT PowerPC)。如果此参数为NULL,则使用调用应用程序和客户机(而不是目标应用程序和打印服务器)的当前环境。

 

注意Windows IA64在Windows XP,Windows XP 64位版,Windows Server 2003和更高版本中可用。Windows XP Service Pack 2(SP2),Windows XP Professional x64 Edition,Windows Server 2003 Service Pack 1(SP1)和更高版本中提供Windows x64。

 

Level

 

[in]指定结构级别。此值必须为1。

 

pPrintProcessorInfo

 

[out]指向接收路径的缓冲区的指针。请注意,对于Windows Server 2003 SP 1之前的操作系统,路径是服务器的本地格式,而不是真正的远程格式。例如,即使在远程服务器被调用时,该路径也以“%Windir%\\ System32 \\ Spool \\ Prtprocs \\%Environment%”的形式给出,而不是“\\\\ ServerName \\ Print $ \\ Prtprocs \\%Environment%”。对于操作系统Windows Server 2003 SP 1及更高版本,将返回真正的远程路径。

 

cbBuf

 

[in]指定由pPrintProcessorInfo指向的缓冲区的大小。

 

pcbNeeded

 

[out]指向如果函数成功指定复制的字节数的值的指针,或cbBuf太小所需的字节数。

 

返回值

 

如果函数成功,则返回值为非零值。

 

如果函数失败,返回值为零。

 

备注

 

Windows 95/98 / Me:Microsoft Layer for Unicode支持GetPrintProcessorDirectoryW.

 

引用文件 #INCLUDE Once

 

WinSpool.inc(包括Windows.inc)