Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 8 - Dial-In Networks / Dial-in Networks Reference

Data Structures / Network Frame

GetAccessNumbers

networkFrame:GetAccessNumbers(worksiteFrame, cityFrame)

Called to retrieve an array of access numbers for a given worksite or city.

worksiteFrame

A frame of the format of a Names worksite soup entry; see "Worksite Entries" (page 16-22) in Chapter 16, "Built-in Applications and System Data Reference," in Newton ProgrammerŐs Reference .

cityFrame

A frame with the same format as the frames returned by the GetCityEntry function; see "GetCityEntry" (page 16-79) in Newton Programmer's Reference.

return value

Return either an array of access frames, or nil if no numbers are available; access frames are described in "Access Frame". You should never, however, return the empty array ([]).

DISCUSSION

It is up to you to implement a mechanism to store and retrieve these access numbers. One possible implementation is to store a frame containing this data in your package. If this data needs to be dynamic, to add new access numbers for example, you will probably want to create a soup for this data.