NWAPPLaunchApplicationId(3nw)

NWAPPLaunchApplicationId -- performs all of the necessary actions to launch an application and returns a unique ID for the specified application

Synopsis

   #include <nwapp.h> 
    
   nint16 N_API N_EXPORT NWAPPLaunchApplicationId 
     (APP_CONTEXT_HANLDE   dContext; 
      pnstr8               dsObject; 
      nint16              uniqueId; 
      nint16              errorRslt; 
      pnstr8               errorStr);

Description

The parameters are as follows:

dContext: (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.
uniqueId: (OUT) Returns a unique ID identifying the application that was launched. This value is used to call NWAPPMonitorApplicationById.
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

NWAPPLaunchApplicationId 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.

If NWAPPLaunchApplicationId fails, uniqueId is undefined.

When APP_SUCCESS is not returned, errorStr and errorRslt are set to the following values:

Return Code errorRslt Value errorStr Value

E_GETTING_ATTRS Undefined Directory Services object name

E_INVALID_DRIVE_PATH NetWare Return Code Executable file path

E_INVALID_QUEUE_PATH NetWare Return Code Resource for the capture

E_AUTH_FAILED NetWare Return Code Name of the server

E_INVALID_MAP_DRIVE NetWare Return Code Resource for the mapping

E_CAPTURE_PORT NetWare Return Code Capture command

E_CAPTURE_FLAG NetWare Return Code Capture command

E_CAPTURE_SETTINGS NetWare Return Code Capture command

E_SCRIPT_FAILED NetWare Return Code Relative path after the root

E_EXEC_FAILED Undefined Executable file path

Return Code	errorRslt Value	errorStr Value
E_GETTING_ATTRS	Undefined	Directory Services object name
E_INVALID_DRIVE_PATH	NetWare Return Code	Executable file path
E_INVALID_QUEUE_PATH	NetWare Return Code	Resource for the capture
E_AUTH_FAILED	NetWare Return Code	Name of the server
E_INVALID_MAP_DRIVE	NetWare Return Code	Resource for the mapping
E_CAPTURE_PORT	NetWare Return Code	Capture command
E_CAPTURE_FLAG	NetWare Return Code	Capture command
E_CAPTURE_SETTINGS	NetWare Return Code	Capture command
E_SCRIPT_FAILED	NetWare Return Code	Relative path after the root
E_EXEC_FAILED	Undefined	Executable file path

 
 ----------------------------------------------------------------------------- 
| Return Code         |  errorRslt Value    |  errorStr Value                | 
|---------------------|---------------------|--------------------------------| 
| E_GETTING_ATTRS     |  Undefined          |  Directory Services object name| 
|---------------------|---------------------|--------------------------------| 
| E_INVALID_DRIVE_PATH|  NetWare Return Code|  Executable file path          | 
|---------------------|---------------------|--------------------------------| 
| E_INVALID_QUEUE_PATH|  NetWare Return Code|  Resource for the capture      | 
|---------------------|---------------------|--------------------------------| 
| E_AUTH_FAILED       |  NetWare Return Code|  Name of the server            | 
|---------------------|---------------------|--------------------------------| 
| E_INVALID_MAP_DRIVE |  NetWare Return Code|  Resource for the mapping      | 
|---------------------|---------------------|--------------------------------| 
| E_CAPTURE_PORT      |  NetWare Return Code|  Capture command               | 
|---------------------|---------------------|--------------------------------| 
| E_CAPTURE_FLAG      |  NetWare Return Code|  Capture command               | 
|---------------------|---------------------|--------------------------------| 
| E_CAPTURE_SETTINGS  |  NetWare Return Code|  Capture command               | 
|---------------------|---------------------|--------------------------------| 
| E_SCRIPT_FAILED     |  NetWare Return Code|  Relative path after the root  | 
|---------------------|---------------------|--------------------------------| 
| E_EXEC_FAILED       |  Undefined          |  Executable file path          | 
|---------------------|---------------------|--------------------------------|

Services

NetWare Application Launcher (NAL) Services