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) |
|
|
Application subroutines. |
