NetIPC 3000/XL Programmer's Reference Manual (5958-8600)

92 Chapter3
NetIPC Intrinsics
IPCGET
IPCGET
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.