Visit Platform at http://www.platform.com

extern LIBESC_API int esc_enableservice(char *, esc_security_def_t *)

Enable a service with ESC

If a service is defined as AUTOMATIC startup type, ESC will enable it during ESC startup. The API is mainly for MANUAL startup type service or if the service was disabled by the esc_disableservice() API.

If the service is in the DEFINED state, the API will trigger state change to INIT. From that point, the service is under ESC management.

If the service is in the DEALLOCATING state, ESC will reject the request with ESCE_SERVICE_DEALLOCATING.

Parameters:
The first parameter IN is the name of the service to be enabled.
The second parameter IN is the security context.When usename and password are both NULL, credentials will be used to authenticate user.
Error on return: May be ESCE_AUTH_FAIL,ESCE_SYS, ESCE_NO_VEMKD, ESCE_ESC_DOWN, ESCE_SOCK_SYS, ESCE_TIME_OUT, ESCE_BAD_ARG, ESCE_NO_MEM, ESCE_XDR, ESCE_NOSUCH_SERVICE, ESCE_SERVICE_DEALLOCATING, ESCE_AUTH_FAIL, ESCE_NO_ADMIN_AUTH, ESCE_NO_AUTH,ESCE_SEC_INIT_FAIL,ESCE_AUTH_FAIL_CRED_EXPIRE, ESCE_PROTOCOL,ESCE_AUTH_ALREADY,ESCE_AUTH_FAIL_CREATE_EXPIRE, ESCE_AUTH_FAIL_UNKNOWN_USER

Returns:
0 if successful. < 0 otherwise.


     
Date Modified: 26 Nov 2007
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 2001-2007 Platform Computing Corporation. All rights reserved.