描述
GetPrinterDataEx功能检索指定的打印机或打印服务器的配置数据。GetPrinterDataEx可以检索由SetPrinterData函数存储的值。此外，GetPrinterDataEx可以通过SetPrinterDataEx函数检索存储在指定键下的值。
C++ 语法
DWORD GetPrinterDataEx( __in HANDLE hPrinter, __in LPCTSTR pKeyName, __in LPCTSTR pValueName, __out LPDWORD pType, __out LPBYTE pData, __in DWORD nSize, __out LPDWORD pcbNeeded ); |
PowerBASIC 语法
FUNCTION GetPrinterDataExA ( _ BYVAL hPrinter AS DWORD, _ BYREF pKeyName AS ASCIIZ, _ BYREF pValueName AS ASCIIZ, _ BYREF pType AS DWORD, _ BYREF pData AS ANY, _ BYVAL nSize AS DWORD, _ BYREF pcbNeeded AS DWORD _ ) AS DWORD |
Unicode版本:
FUNCTION GetPrinterDataW ( _ BYVAL hPrinter AS DWORD, _ BYREF pKeyName AS WSTRINGZ, _ BYREF pValueName AS WSTRINGZ, _ BYREF pType AS DWORD, _ BYREF pData AS ANY, _ BYVAL nSize AS DWORD, _ BYREF pcbNeeded AS DWORD _ ) AS DWORD |
参数
hPrinter
[in]处理该函数检索配置数据的打印机或打印服务器。使用OpenPrinter或AddPrinter功能来检索打印机句柄。
pKeyName
[in]指向指定包含要检索的值的键的以空值结尾的字符串的指针。使用反斜杠（\\）字符作为分隔符来指定具有一个或多个子项的路径。
如果hPrinter是打印机的句柄，并且pKeyName为NULL或空字符串，则GetPrinterDataEx将返回ERROR_INVALID_PARAMETER。
如果hPrinter是打印服务器的句柄，pKeyName将被忽略。
pValueName
[in]指向用于标识要检索的数据的以null结尾的字符串的指针。
对于打印机，此字符串指定pKeyName键下的值的名称。
对于打印服务器，此字符串是以下备注部分中列出的预定义字符串之一。
pType
[out]指向接收存储在值中的数据类型的变量的指针。当存储数据时，该函数返回在SetPrinterDataEx调用中指定的类型。如果不需要信息，此参数可以为NULL。GetPrinterDataEx通过PTYPE作为RegQueryValueEx函数调用的lpdwType参数。
pData
[out]指向接收配置数据的缓冲区的指针。
nSize
[in]指定pData指向的缓冲区的大小（以字节为单位）。
pcbNeeded
[out]指向接收大小（以字节为单位）的配置数据的变量的指针。如果服务提供商指定的缓冲区大小太小，则函数返回ERROR_MORE_DATA，pcbNeeded表示所需的缓冲区大小。
返回值
如果函数成功，则返回值为ERROR_SUCCESS。
如果函数失败，则返回值为错误值。
备注
GetPrinterDataEx检索由SetPrinterDataEx和SetPrinterData功能设置的打印机配置数据。
如果hPrinter是打印服务器的句柄，pValueName可以指定以下预定义值之一。
SPLREG_ALLOW_USER_MANAGEFORMS
Windows XP，SP2或更高版本。
Windows Server 2003，SP1或更高版本。
SPLREG_ARCHITECTURE
SPLREG_BEEP_ENABLED
SPLREG_DEFAULT_SPOOL_DIRECTORY
SPLREG_DNS_MACHINE_NAME
SPLREG_DS_PRESENT
成功返回后，pData如果机器位于DS域，则包含&H0001，否则为0。
SPLREG_DS_PRESENT_FOR_USER
成功返回后，如果用户登录到DS域，则pData包含&H0001，否则为0。
SPLREG_EVENT_LOG
SPLREG_MAJOR_VERSION
SPLREG_MINOR_VERSION
SPLREG_NET_POPUP
SPLREG_NET_POPUP_TO_COMPUTER
成功返回时，如果作业通知应发送到客户端计算机，则pData包含1，如果作业通知要发送给用户，则为0。
SPLREG_OS_VERSION
Windows XP或更高版本。
SPLREG_OS_VERSIONEX
Windows 2000或更高版本。
SPLREG_PORT_THREAD_PRIORITY_DEFAULT
Windows 2000或更高版本。
SPLREG_PORT_THREAD_PRIORITY
Windows 2000或更高版本。
SPLREG_PRINT_DRIVER_ISOLATION_GROUPS_SEPARATOR
Windows 7或更高版本。
SPLREG_PRINT_DRIVER_ISOLATION_GROUPS
Windows 7或更高版本。
SPLREG_PRINT_DRIVER_ISOLATION_TIME_BEFORE_RECYCLE
Windows 7或更高版本。
SPLREG_PRINT_DRIVER_ISOLATION_MAX_OBJECTS_BEFORE_RECYCLE
Windows 7或更高版本。
SPLREG_PRINT_DRIVER_ISOLATION_IDLE_TIMEOUT
Windows 7或更高版本。
SPLREG_PRINT_DRIVER_ISOLATION_EXECUTION_POLICY
Windows 7或更高版本。
SPLREG_PRINT_DRIVER_ISOLATION_OVERRIDE_POLICY
Windows 7或更高版本。
SPLREG_REMOTE_FAX
Windows 2000或更高版本。
成功返回后，pData如果传真服务支持远程客户端，则包含&H0001，否则为0。
SPLREG_RETRY_POPUP
Windows 2000或更高版本。
成功返回时，如果服务器设置为重试所有作业的PopUps，则pData包含1，如果服务器未重试所有作业的PopUps，则为0。
SPLREG_SCHEDULER_THREAD_PRIORITY
Windows 2000或更高版本。
SPLREG_SCHEDULER_THREAD_PRIORITY_DEFAULT
Windows 2000或更高版本。
SPLREG_WEBSHAREMGMT
Windows Server 2003或更高版本。
SPLREG_W3SVCINSTALLED
Windows 2000或更高版本。
以下值pValueName表示发生错误时的池打印行为。
SPLREG_RESTART_JOB_ON_POOL_ERROR
pData的值表示发生错误后在其他端口上重新启动作业的时间（以秒为单位）。此设置与SPLREG_RESTART_JOB_ON_POOL_ENABLED一起使用。
SPLREG_RESTART_JOB_ON_POOL_ENABLED
pData中的非零值表示SPLREG_RESTART_JOB_ON_POOL_ERROR已启用。
在SPLREG_RESTART_JOB_ON_POOL_ERROR中指定的时间是最短时间。实际时间可能会更长，这取决于以下端口监视器设置，它们位于HKLM \\ SYSTEM \\ CurrentControlSet \\ Control \\ Print \\ Monitors \\ MonitorName \\ Ports下。
端口监视器设置 |
含义 |
StatusUpdateEnabled |
如果非零值，端口监视器将使用端口状态更新后台处理程序。 |
StatusUpdateInterval |
指定端口监视器使用端口状态更新后台处理程序的时间间隔（以秒为单位）。 |
使用pKeyName参数设置为“PrinterDriverData”调用GetPrinterDataEx相当于调用GetPrinterData函数。
如果pKeyName是预定义的目录服务（DS）键之一（参见SetPrinter），并且pValueName包含逗号（'，'），则将逗号前面的部分pValueName用作值名称并且使用逗号右侧的pValueName部分作为DS属性OID。创建一个名为OID的子项，并在OID键下输入由值名称和OID组成的新值。SetPrinterDataEx还会在DS密钥下添加值名称和数据。
引用文件 #INCLUDE Once
WinSpool.inc（包括Windows.inc）