(IN) Specifies the NDS context of the object. This must be a valid context.
dsObject
(IN) Specifies the full Directory Service name of the application to be launched.
errorRslt
(OUT) Returns the NetWare error if a problem occurred.
errorStr
(OUT) Points to a string indicating the error if an error was returned. You must allocate memory for this string (maximum length is 255 characters).
Return values
APP_SUCCESS
Application was launched successfully.
APP_ERROR
Application could not be launched. Problem is unknown.
E_GETTING_ATTRS
Could not retrieve the object attributes.
E_INVALID_DRIVE_PATH
The path to the executable was invalid.
E_INVALID_QUEUE_PATH
The path to the queue was invalid.
E_AUTH_FAILED
Authentication failed.
E_INVALID_MAP_DRIVE
Mapping the drive failed.
E_CAPTURE_PORT
The capture failed. The syntax for the capture may be incorrect.
E_CAPTURE_FLAG
The call to set the capture flags failed.
E_CAPTURE_SETTINGS
The capture failed.
E_SCRIPT_FAILED
The pre or post launch script failed to execute.
E_EXEC_FAILED
The application could not be launched.
Notices
NWAPPLaunchApplication performs all maintenance necessary to start an application including mapping drives, capturing printers, pre and post setup or cleanup.
Call NWAPPMonitorApplications to track and clean up resources.
When APP_SUCCESS is not returned, errorStr and errorRslt are set to the following values: