dispUnregisterRTCAlias

Removes an RTC condition event alias from the RTC database.

Prototype

DWORD dispUnregisterRTCAlias (CTAHD ctahd, RTC_ALIAS *alias )

Argument

Description

ctahd

Handle to a Natural Access context.

alias

Pointer to the RTC_ALIAS array, defined as:

typedef struct
{
  DWORD EventID;                /* RTC condition event */
  char   Alias[ RTC_NAME_LEN ]; /* ASCII name          */
} RTC_ALIAS;


Return values

Return value

Description

SUCCESS

 

CTAERR_BAD_ARGUMENT

alias is NULL, alias contains a zero length Alias string, or the EventID is not a valid service event.

CTAERR_INVALID_CTAHD

Specified ctahd is invalid.

CTAERR_NOT_FOUND

Specified alias could not be found in the RTC database.

CTAERR_NOT_INITIALIZED

Natural Access is not initialized.

CTAERR_SVR_COMM

Natural Access Server is not running.


Details

dispUnregisterRTCAlias removes an alias from the RTC database. dispUnregisterRTCAlias should be called by the xxxCloseService binding function if a corresponding dispRegisterRTCAlias function was performed at the time of the xxxOpenService binding function call.

See also

dispRemoveRTC