3.1.4.11.1 LOCALMON

This section describes the implementation of XcvData methods in LOCALMON. This monitor module is used to control parallel and serial ports that could have a printer connected to them.<387>

For parallel and serial port naming, see section 2.2.4.10. For more information about the values listed in the left column in the following table, see section 3.1.4.6.5.

Value

Description

"MonitorUI"

This action returns the name of the client-side interface monitor. The pOutputData parameter is a pointer to the buffer that receives the string representing the name of the interface monitor.

"AddPort"

This action adds a local port. The pInputData parameter is a pointer to a string representing the name of the port.

"DeletePort"

This action deletes a local port. The pInputData parameter is a pointer to a string representing the name of the port.

"ConfigureLPTPortCommandOK"

This action determines configuration of the LPT port and sets the transmission retry timeout. The pInputData parameter is a pointer to a string representing a number from 1 through 3, inclusive. Those numbers map to the port to configure, whether it is "LPT1" OR "LPT2" OR "LPT3". The pOutputData parameter is not used.

"PortExists"

This action checks whether a local port exists in the print server's list of port objects. The pInputData parameter is a pointer to a string representing the name of the port. The pOutputData parameter is a pointer to a DWORD variable that MUST receive the value 0 if the port does not exist and a nonzero value if the port exists.

"PortIsValid"

This action determines whether a given name is a valid port name accepted by the port monitor. The pInputData parameter is a pointer to a string representing the name of the port. If the port identifies a valid port name, the method MUST return ERROR_SUCCESS; otherwise, it MUST return a nonzero error code.