SetPort

【勇芳软件工作室】汉化HomePreviousNext

[New - Windows NT]

SetPort功能设置与打印机端口相关联的状态。

BOOL SetPort(

LPTSTR 【PNAME】,//指向打印机服务器名称的指针
LPTSTR 【pPortName】,//指向打印机端口名称的指针
DWORD 【// version of PORT_INFO_* structure】//版本的PORT_INFO_ *结构
LPBYTE 【pPortInfo】//指向PORT_INFO_ *结构的指针
); 

参数

【PNAME】

指向零终止字符串的指针,该字符串指定端口连接到的打印机服务器的名称。如果端口在本地机器上,则将此参数设置为NULL。

【pPortName】

指向指定打印机端口名称的零终止字符串的指针。

【//原子或字符串的地址】

指定【pPortInfo】参数指向的PORT_INFO_ *结构的类型。

此值必须为3,对应于PORT_INFO_3数据结构。

【pPortInfo】

指向PORT_INFO_3结构的指针,其中包含要设置的端口状态信息。

返回值

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

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

SetPort功能的调用者必须具有SERVER_ACCESS_ADMINISTER访问端口连接的服务器。

当您使用严重性值PORT_STATUS_TYPE_ERROR设置打印机端口状态值时,打印后台处理程序将停止向端口发送作业。当端口状态被另一个调用SetPort清除时,打印后台处理程序将恢复发送作业到端口。

也可以看看

PORT_INFO_3