Inside Macintosh: Open Transport /

Chapter 6 - Configuration Management / Configuration Management Reference

Functions / Getting Information About Ports

OTFindPort

Obtains information about a port that corresponds to a given port name.

C INTERFACE

Boolean OTFindPort (OTPortRecord* record, 
                    const char* portName);

C++ INTERFACES

None. C++ applications use the C interface to this function.

PARAMETERS

record

A pointer to a port structure that contains information about the port you specified with the portName parameter.

portName

The name of the port about which you want information.

DESCRIPTION

The OTFindPort function returns information about a port that corresponds to a given port name. Each port in a system has a unique port name, which you can obtain through a previous call or set of calls to the OTGetIndexedPort function.

You must allocate the port structure; the function fills this structure with information about the port indicated by the portName parameter. If the function returns false, the contents of the structure are not significant.

SEE ALSO

For information about finding ports, see the sections "About Port Information" (page 6-5) and "Obtaining Port Information" (page 6-11).

You can use the OTGetIndexedPort function (page 6-32) to get port information by iterating through all available ports.

The port structure is described in "The Port Structure" (page 6-17).