NETPortCreate()

Description

NETPortCreate() is used to create a NETPort object.

Call Signature

NETPort ptr NETPortCreate ( [string port_name] )

Return Value

NETPort ptr

The new NETPort is returned by NETPortCreate() or NULL for failure. See Remarks.

Argument

[ string port_name ]:

Optional name for the port being created. If skipped a default name will be constructed.

Remarks

The new NETPort is returned by NETPortCreate(). Normally, once the NETPort is created, the PortID would be queried and then made available to potential client processes.

The optional port_name parameter is normally not of significant interest, but one special form can be important. If the name is of the form "PORT=n" then the system will attempt to use a particular port number. Normally ports less than 1025 are reserved for system use. Attempts to select a particular port may fail if it is already in use by an application on this system, or for other reasons in which case a NULL NETPort will be returned.

See also

NETPort class

Inter-process communication

© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.