hmiReset

Requests the local HMI to read the configuration file again.

Prototype

DWORD hmiReset ( CTAHD ctahd)

Argument

Description

ctahd

Natural Access handle from a previous successful call to ctaOpenServices.


Return values

Return value

Description

SUCCESS

 

HMI_ERR_BADCMD

Request failed. An event handle was passed to the Health Management service command.

HMI_ERR_CLOSED

Request failed. Connection closed by HMI.

HMI_ERR_INTERROR

Request failed. Unknown I/O error occurred.

HMI_ERR_INVHANDLE

Handle is not valid.

HMI_ERR_NOMEM

No memory available.

HMI_ERR_TIMEOUT

Request failed. No response from HMI.


Details

A reset causes the HMI to re-read its configuration file. You can reconfigure by editing the HMI configuration file and issuing a reset request. However, the ports assigned to the HMI are not reconfigured on a reset. The HMI must be stopped and restarted to change ports.

All existing application connections are preserved during a reset.