prt_api_register_intproc
Name
prt_api_register_intproc
Purpose
Register as an interested process.
Description
This function provides a mechanism for a process to request to register as an interested process to a PRT process. Either this initialization routine must be called by all PRT interested processes prior to calling any other PRT_API interested process utilities or prt_api_dyn_register_intproc. The calling routine receives back a status indicating the success or failure of the request. This routine is used when you have configured your process as a service and is included in the prt_service.dat file. If this is not the case then you must use prt_api_dyn_register_intproc.
Syntax
int prt_api_register_intproc (intproc_event_flag, retstat)
COR_I4 intproc_event_flag;
COR_STATUS *retstat;Data Structures
None
Arguments
| Argument | Description |
|---|---|
| Input | |
| intproc_event_flag | Interested process event flag (required) |
| Output | |
| *retstat | Pointer to COR_STATUS structure |
Return Value
Either COR_SUCCESS or COR_FAILURE.
If the function returns COR_FAILURE additional error information can be found in the COR_STATUS structure.
Error Codes
| PRTI_PROC_NOT_CONFIGURED | Process is not configured as network process (Failure) |
| PRTI_FILE_OPEN_ERR | Error opening one of the configuration files (Failure) |
| PRTI_SVC_ID_NDEF | PRT service identifier not valid (Failure) |
| PRTI_FILE_READ_ERR | Error reading configuration file (Failure) |
| PRTI_EMPTY_FILE | Configuration file has no records (Failure) |
| PRTI_AUX_NAM_ERR | Error in ipc_aux_nam (Failure) |
| PRTI_ADD_PORT_ERR | Error in ipc_add_port (Failure) |
| PRTI_READ_PORT_ERR | Error in ipc_read_port (Failure) |
| PRTI_MF_INIT_ERR | Error initializing segment (Failure) |
| PRTI_CRESEG_ERR | Error creating segment (Failure) |
| PRTI_BAD_MSG | Error in segment (Failure) |
| PRTI_BAD_SVC_NAME | Bad service name (no underscore) (Failure) |
| PRTI_XLATE_ERR | Error in ipc_xlate getting physical addr (Failure) |
| PRTI_WRITE_PORT_ERR | Error in ipc_write_port (Warn/Fail) |