勇芳软件工作室.汉化:  Printing > Print Spooler API > Print Spooler API Reference > Print Spooler API Functions >

GetDefaultPrinter

Previous pageReturn to chapter overviewNext page

描述

 

GetDefaultPrinter功能检索本地计算机上当前用户的默认打印机的打印机名称。

 

C++ 语法

 

BOOL GetDefaultPrinter(

__in    LPTSTR pszBuffer,

__inout LPDWORD pcchBuffer

);

 

PowerBASIC 语法

 

FUNCTION GetDefaultPrinterA ( _

BYREF pszBuffer AS ASCIIZ, _

BYREF pcchBuffer AS DWORD _

) AS LONG

 

Unicode版本:

 

FUNCTION GetDefaultPrinterW ( _

BYREF pszBuffer AS WSTRINGZ, _

BYREF pcchBuffer AS DWORD _

) AS LONG

 

参数

 

pszBuffer

 

[in]指向缓冲区的指针,该缓冲区接收包含默认打印机名称的以空值终止的字符串。如果此参数为NULL,则该函数失败,并且pcchBuffer指向的变量以字符返回所需的缓冲区大小。

 

pcchBuffer

 

[in, out]在输入上,指定pszBuffer缓冲区的大小(以字符为单位)。在输出时,接收打印机名称字符串的大小(包括字符),包括终止空字符。

 

返回值

 

如果函数成功,则返回值为非零值,并且pcchBuffer指向的变量包含复制到pszBuffer缓冲区的字符数,包括终止空字符。

 

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

 

含义

ERROR_INSUFFICIENT_BUFFER

pszBuffer缓冲区太小。pcchBuffer指向的变量包含所需的缓冲区大小(以字符为单位)。

ERROR_FILE_NOT_FOUND

没有默认打印机。

 

引用文件 #INCLUDE Once

 

WinSpool.inc(包括Windows.inc)