Up: GEOS SDK TechDocs| Up | Prev: GEOS C Routines: ... | Next: AccessPointGetStringPropertyBlock() ...

AccessPointCommit()

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

AccessPointCompareStandardProperty()

void AccessPointCompareStandardProperty(
        AccessPointStandardProperty 					prop,
        char 					*str);

This routine compares the passed string to the name of the passed property.

Include: accpnt.goh

AccessPointCreateEntry()

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:

loc
The access point before which to insert the new access point. Pass zero to append the new access point to the end of the list.
apt
The 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().

AccessPointDestroyEntry()

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

AccessPointDestroyProperty()

Boolean AccessPointDestroyProperty(
        word id, 
        char *prop);

This routine destroys one of an access point's properties.

Pass:

id
The access point's ID number.
prop
Either an 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().

AccessPointGetEntries()

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:

mh
The memory block in which the chunk array shall reside.
chunk
Either the ChunkHandle of a chunk array, or zero to request that the library allocate a chunk array.
apt
The AccessPointType we're interested in: APT_INTERNET, APT_TERMINAL, etc.

Return: The ChunkHandle of the chunk array.

Include: accpnt.goh

AccessPointGetIntegerProperty()

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:

id
The access point's ID number.
prop
Either an AccessPointStandardProperty value or a pointer to a buffer containing the property's name.
val
Pointer to an integer; the routine will fill in this integer with the value of the property.

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().


Up: GEOS SDK TechDocs| Up | Prev: GEOS C Routines: ... | Next: AccessPointGetStringPropertyBlock() ...