void AccessPointCommit();
This routine commits any access point data changes to permanent storage. The AccPnt library normally calls this routine when the device shuts down; applications thus need not call it. If you're trying to track down a bug which is likely to cause the system to crash before the changes can be committed, you may find this routine useful.
Include: accpnt.goh
void AccessPointCompareStandardProperty( AccessPointStandardProperty prop, char *str);
This routine compares the passed string to the name of the passed property.
Include: accpnt.goh
word AccessPointCreateEntry( word loc, AccessPointType apt);
This routine creates a new access point.
After calling this routine, you will probably want to use the
AccessPointSet...Property()
routines to provide some information about the new access point.
Pass:
AccessPointType
of the new access point. APT_INTERNET for an ISP, APT_TERMINAL for a dialup, etc.Return: ID number of the new access point.
Include: accpnt.goh
See Also: AccessPointSetStringProperty()
,AccessPointSetIntegerProperty()
.
Boolean AccessPointDestroyEntry( word id);
This routine deletes an access point's information. If it returns non-zero, there was an error. (Perhaps the access point was locked or did not exist.)
Include: accpnt.goh
Boolean AccessPointDestroyProperty( word id, char *prop);
This routine destroys one of an access point's properties.
Pass:
AccessPointStandardProperty
value or a pointer to a buffer containing the property's name.Return: Zero if there was no error, true if there was (no such access point, no such property, access point locked).
Include: accpnt.goh
See Also: AccessPointSetStringProperty()
,AccessPointSetIntegerProperty()
.
ChunkHandle AccessPointGetEntries( MemHandle mh, ChunkHandle chunk, AccessPointType apt);
This routine gets a chunk array of all the access point IDs corresponding to access points of a given
AccessPointType
. Each element of the arraay is word-sized.
Pass:
AccessPointType
we're interested in: APT_INTERNET, APT_TERMINAL, etc.
Return:
The
ChunkHandle
of the chunk array.
Include: accpnt.goh
Boolean AccessPointGetIntegerProperty( word id, char *prop, int *val);
This routine retrieves the value of one of an access point's property, representing the value as an integer.
Pass:
AccessPointStandardProperty
value or a pointer to a buffer containing the property's name.Return: Zero if there was no error, true if there was (no such access point, no such property).
Include: accpnt.goh
See Also: AccessPointGetStringPropertyBuffer()
,AccessPointGetStringPropertyBlock()
.