ems_register - register with XEMS
#include <xems.h>
void ems_register(
ems_netname_t * hostname,
ems_handle_t * handle,
ems_error_t * status);
This routine registers with EMS by obtaining an EMS handle. The EMS handle is then used to on future calls to the Event Service.
- Input
- hostname
the name of the host machine where an Event Service is running. If the hostname is NULL, then the local host is assumed
- Output
- handle
returns an EMS handle to use for future calls to EMS routines.
- status
returns the status code from this routine which indicates whether the routine completed successfully or, if not, why not.
The possible status codes are:
ems_s_status_ok
ems_s_unsupported_nameservice
ems_unregister - unregister with XEMS.
#include <xems.h>
void ems_unregister(
ems_handle_t * handle,
ems_error_t * status);
This routine unregisters an EMS handle with EMS. The resources held by the XEMS handle are freed, and handle is assigned NULL. The handle can be one obtained byems_register() orems_consumer_register() .
- Input
- handle
the EMS handle to unregister.
- Output
- handle
assigns NULL to handle.
- status
returns the status code from this routine which indicates whether the routine completed successfully or, if not, why not.
The possible status codes are:
ems_s_status_ok
ems_s_invalid_handle
Contents | Next section | Index |