|
|
|
Obtains a VC socket or call socket descriptor that has been given away by
another process.
Syntax
IPCGET ( givename, nlen, flags, descriptor, result )
Parameters
- givename (input)
- Character array, by reference. The temporary name assigned to the
socket when it was given away. It is up to 16 characters long.
- nlen (input)
- 32-bit integer, by value. The length in bytes of the specified
name.
- flags
- 32 bits, by reference. A bit representation of various options.
No flags are currently defined for this intrinsic.
- descriptor (output)
- 32-bit integer, by reference. The VC socket or call socket
descriptor that was given away via the IPCGIVE command.
- result (output)
- 32-bit integer, by reference. The error code returned; zero if no
error.
Description
The IPCGET intrinsic allows a process to obtain ownership of a VC
socket or call socket descriptor that has been relinquished by another process
through the IPCGIVE intrinsic. A temporary name identifies the socket
for the process which wishes to acquire it. All the parameters are required.
Condition codes returned by this intrinsic are:
- CCE — Succeeded.
- CCL — Failed.
- CCG — Not returned by this intrinsic.
This intrinsic cannot be called in split stack mode.
|
