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

AddPrintProcessor

Previous pageReturn to chapter overviewNext page

描述

 

AddPrintProcessor功能在指定的服务器上安装打印处理器,并将打印处理器名称添加到支持的打印处理器的内部列表中。

 

C++ 语法

 

BOOL AddPrintProcessor(

__in LPTSTR pName,

__in LPTSTR pEnvironment,

__in LPTSTR pPathName,

__in LPTSTR pPrintProcessorName

);

 

PowerBASIC 语法

 

FUNCTION AddPrintProcessorA ( _

BYREF pName AS ASCIIZ, _

BYREF pEnvironment AS ASCIIZ, _

BYREF pPathName AS ASCIIZ, _

BYREF pPrintProcessorName AS ASCIIZ _

) AS LONG

 

Unicode版本:

 

FUNCTION AddPrintProcessorW ( _

BYREF pName AS WSTRINGZ, _

BYREF pEnvironment AS WSTRINGZ, _

BYREF pPathName AS WSTRINGZ, _

BYREF pPrintProcessorName AS WSTRINGZ _

) AS LONG

 

参数

 

pName

 

[in]指向指定要在其上安装打印处理器的服务器的名称的以null结尾的字符串的指针。如果此参数为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。

 

pPathName

 

[in]指向指定包含打印处理器的文件名称的以空值终止的字符串的指针。该文件必须位于系统打印处理器目录中。

 

pPrintProcessorName

 

[in]指向指定打印处理器名称的以空值终止的字符串的指针。

 

返回值

 

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

 

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

 

备注

 

来电者必须拥有SeLoadDriverPrivilege.

 

在调用AddPrintProcessor函数之前,应用程序应验证包含打印处理器的文件是否存储在系统打印处理器目录中。应用程序可以通过调用GetPrintProcessorDirectory功能来检索系统打印处理器目录的名称。

 

应用程序可以通过调用EnumPrintProcessors函数来确定现有打印处理器的名称。

 

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

 

引用文件 #INCLUDE Once

 

WinSpool.inc(包括Windows.inc)