Inside Macintosh: Open Transport /

Chapter 11 - AppleTalk Service Providers / AppleTalk Service Provider Reference

Functions / Obtaining Information About Your AppleTalk Environment

OTATalkGetInfo

Obtains information about the AppleTalk environment for a given node.

C INTERFACE

OSStatus OTATalkGetInfo(ATSvcRef ref, TNetbuf* info);

C++ INTERFACE

TAppleTalkServices::GetInfo(TNetbuf* info);

PPARAMETERS

ref

The reference value of your AppleTalk service provider.

info

A pointer to a TNetbuf structure that you use to get information about your current AppleTalk environment.

DESCRIPTION

The OTATalkGetInfo function returns the information contained in the AppleTalkInfo data structure that describes your current AppleTalk environment. This includes your network number and node ID, the network number and node ID of a local router, and the current network range for the extended network to which the machine is connected.

If you execute this function asynchronously, Open Transport calls your notifier with a T_GETATALKINFOCOMPLETE completion event to signal the function's completion and uses your notifier's cookie parameter for the AppleTalk information. The cookie parameter actually holds a pointer to a TNetbuf structure, which points in turn to a buffer containing the AppleTalkInfo structure. The maximum size of this buffer is 22 bytes.

If the machine is multihomed--that is, if multiple network numbers and node numbers are associated with the same machine--the OTATalkGetInfo function returns information about the node whose network number and node ID are selected in the AppleTalk control panel.

COMPLETION EVENT CODES

T_GETATALKINFOCOMPLETE

0x23010004

The OTATalkGetInfo function has completed.

SEE ALSO

The AppleTalkInfo data structure is described in the section "Constants and Data Types" (page 11-9).