描述
SetPort功能设置与打印机端口相关联的状态。
C++ 语法
BOOL SetPort( __in LPTSTR pName, __in LPTSTR pPortName, __in DWORD dwLevel, __in LPBYTE pPortInfo ); |
PowerBASIC 语法
FUNCTION SetPortA ( _ BYREF pName AS ASCIIZ, - BYREF pPortName AS ASCIIZ, _ BYVAL dwLevel AS DWORD, _ BYREF pPortInfo AS ANY _ ) AS LONG |
Unicode版本:
FUNCTION SetPortW ( _ BYREF pName AS WSTRINGZ, - BYREF pPortName AS WSTRINGZ, _ BYVAL dwLevel AS DWORD, _ BYREF pPortInfo AS ANY _ ) AS LONG |
参数
pName
[in]指向一个零终止字符串的指针，指定端口连接到的打印机服务器的名称。如果端口在本地机器上，则将此参数设置为NULL。
pPortName
[in]指向指定打印机端口名称的零终止字符串的指针。
dwLevel
[in]指定pPortInfo参数指向的结构类型。
此值必须为3，对应于PORT_INFO_3数据结构。
pPortInfo
[in]指向包含要设置的端口状态信息的PORT_INFO_3结构的指针。
返回值
如果函数成功，则返回值为非零值。
如果函数失败，返回值为零。
备注
SetPort函数的调用者必须以管理员身份执行。另外，如果呼叫者是端口监视器或语言监视器，它必须调用RevertToSelf才能停止模拟，然后再呼叫SetPort.
调用SetPort的所有程序必须对连接到端口的服务器具有SERVER_ACCESS_ADMINISTER访问权限。
当您使用严重性值PORT_STATUS_TYPE_ERROR设置打印机端口状态值时，打印后台处理程序将停止向端口发送作业。当端口状态被另一次调用SetPort清除时，打印后台处理程序将恢复发送作业到端口。
引用文件 #INCLUDE Once
WinSpool.inc