Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Networking /
Chapter 2 - AppleTalk Utilities / About the AppleTalk Utilities


Getting Information About the .MPP Driver and the
Network Environment

This section describes how you can use the PGetAppleTalkInfo function to obtain information about the installed version of the .MPP driver, the network environment, and the .MPP driver's maximum capacities, such as the number of sockets and the number of NBP calls that the .MPP driver supports. The .MPP driver implements
these protocols:

Before you call the PGetAppleTalkInfo function, you must allocate memory for and define a parameter block of type MPPParmType. The section "MPP Parameter Block" beginning on page 2-9 shows this data structure. You must also allocate memory for and provide pointers to the data buffers into which the PGetAppleTalkInfo function returns the data-link address and zone name for extended networks.

The PGetAppleTalkInfo function's Boolean parameter allows you to specify whether the function is to be executed synchronously or asynchronously. This function is generally executed synchronously. (For information on these two modes, see the chapter "Introduction to AppleTalk" in this book.)

The PGetAppleTalkInfo function returns the following information:

The data-link address and the zone name are returned only for extended networks--that is, network types that allow more than one network number per network. You use the laLength parameter to specify the length of the data-link address you want returned; the function returns the actual length of the data in the laLength parameter and returns the data in the buffer you provide.

The ExtendedBit flag returned by the PGetAppleTalkInfo function is TRUE if the node is connected to an extended AppleTalk network. (The ExtendedBit flag is bit 15 of the configuration parameter returned by this function.) Note that the presence of
the AppleTalk Phase 2 drivers does not of itself indicate that the node is connected to
an extended network. For more information, see "PGetAppleTalkInfo" beginning on page 2-11.

Note
Always use the PGetAppleTalkInfo function to obtain information about the .MPP driver. You cannot rely on the validity of the MPP global variables pointed to by the varsPtr parameter block field value for this information.

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996