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

PRINTER_INFO_7

Previous pageReturn to chapter overviewNext page

描述

 

PRINTER_INFO_7结构指定目录服务打印机信息。使用SetPrinter功能使用此结构在目录服务(DS)中发布打印机的数据,或从DS更新或删除打印机的已发布数据。使用此结构与GetPrinter功能来确定打印机是否在DS中发布。

 

C++ 语法

 

typedef struct _PRINTER_INFO_7 {

LPTSTR pszObjectGUID;

DWORD  dwAction;

} PRINTER_INFO_7,

*PPRINTER_INFO_7;

 

PowerBASIC 语法

 

TYPE PRINTER_INFO_7A

pszObjectGUID AS ASCIIZ PTR

dwAction      AS DWORD

END TYPE

 

Unicode版本:

 

TYPE PRINTER_INFO_7W

pszObjectGUID AS WSTRINGZ PTR

dwAction      AS DWORD

END TYPE

 

成员

 

pszObjectGUID

 

指向包含与已发布打印机关联的目录服务打印队列对象的GUID的以null结尾的字符串。使用GetPrinter功能检索此GUID。

 

在调用SetPrinter之前,将pszObjectGUID设置为NULL。

 

dwAction

 

指示SetPrinter功能执行的操作。对于GetPrinter功能,该成员指示指定的打印机是否已发布。该成员可以是以下值的组合。

 

描述

DSPRINT_PUBLISH

SetPrinter:在DS中发布打印机的数据。

GetPrinter:表示打印机已发布。

DSPRINT_UNPUBLISH

SetPrinter:从DS中删除打印机的已发布数据。

GetPrinter:表示打印机未发布。

DSPRINT_UPDATE

SetPrinter:更新打印机在DS中发布的数据。

GetPrinter:永远不会返回此值。

DSPRINT_PENDING

GetPrinter:表示系统正在尝试完成由SetPrinter:呼叫启动的发布或取消发布操作。

此值对SetPrinter无效:通话。

DSPRINT_REPUBLISH

SetPrinter:打印机的DS数据未发布,然后再次发布,刷新已发布打印机中的所有属性。重新发布还会更改已发布打印机的GUID。

GetPrinter:从不返回此值。

 

备注

 

PRINTER_INFO_7结构用于SetPrinter调用,以将打印机信息发布到目录服务。发布的数据包括在SetPrinterDataEx创建的SPLDS_SPOOLER_KEY,SPLDS_DRIVER_KEY或SPLDS_USER_KEY密钥下找到的指定打印机的所有值和数据。

 

对于SetPrinterpszObjectGUID应设置为NULL。对于GetPrinterpszObjectGUID返回与已发布打印机关联的目录服务打印队列对象的GUID。您可以使用此GUID与Active Directory服务接口(ADSI)方法来检索打印机的已发布数据。但是,推荐的检索已发布数据的方法是调用GetPrinterDataEx函数。

 

引用文件 #INCLUDE Once

 

WinSpool.inc(包括Windows.inc)