| GEOS SDK TechDocs | | AccessPointCommit() ... | ArrayQuickSort() ...

---

AccessPointGetStringPropertyBlock()

BooleanAccessPointGetStringPropertyBlock(
        word 		id,
        char 		*prop,
        MemHandle 		*data,
        int 		*datalen);

This routine retrieves the value of one of an access point's property, returning the value as a string in a block of memory.

Pass:

id

The access point's ID number.

prop

Either an AccessPointStandardProperty value or a pointer to a buffer containing the property's name.

data

MemHandle of block to fill with value (pass zero to request that the block be allocated).

dataLen

Pointer to integer; the routine will fill in this integer with the length of the value string, excluding the trailing NULL.

Return: Zero if there was no error, true if there was (no such access point, no such property).

Include: accpnt.goh

See Also: AccessPointGetStringPropertyBuffer(), AccessPointGetIntegerProperty().

AccessPointGetStringPropertyBuffer()

Boolean AccessPointGetStringPropertyBuffer(
        word 	id,
        char 	*prop,
        char 	*buf,
        int 	*datalen);

This routine retrieves the value of one of an access point's property, returning the value as a string in a buffer of memory.

Pass:

id

The access point's ID number.

prop

Either an AccessPointStandardProperty value or a pointer to a buffer containing the property's name.

buf

Pointer to buffer to fill with value.

dataLen

Pointer to integer; pass the size of buf. The routine will fill in this integer with the length of the value string.

Return: Zero if there was no error, true if there was (no such access point, no such property).

Include: accpnt.goh

See Also: AccessPointGetStringPropertyBlock(), AccessPointGetIntegerProperty().

AccessPointGetType()

AccessPointType AccessPointCommit(
        word id);

This routine returns the type of an access point: APT_INTERNET, APT_TELNET, etc.

Include: accpnt.goh

AccessPointInUse()

Boolean   AccessPointInUse (word id);

If the access point with the ID id is being used by a connection, then this routine returns TRUE (non-zero); otherwise, it returns FALSE (zero).

Include: accpnt.goh

AccessPointIsEntryValid()

Boolean AccessPointIsEntryValid(
        word id);

This routine returns zero if the passed access point does not exist; it returns non-zero if it does exist.

Include: accpnt.goh

AccessPointLock()

void AccessPointLock(
        word id);

This routine locks an access point, preventing changes to it.

Include: accpnt.goh

See Also: AccessPointUnlock().

AccessPointSetIntegerProperty()

Boolean AccessPointSetIntegerProperty(
        word 	id,
        char+ 	*prop,
        int 	val);

This routine sets the value of one of an access point's properties to 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

The new value for the property.

Return: Zero if there was no error, true if there was (no such access point, access point locked).

Include: accpnt.goh

See Also: AccessPointSetStringProperty().

AccessPointSetStringProperty()

Boolean AccessPointSetStringProperty(
        word id,
        char *prop,
        char *val);

This routine sets the value of one of an access point's properties to a string.

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

The new value for the property.

Return: Zero if there was no error, true if there was (no such access point, access point locked).

Include: accpnt.goh

See Also: AccessPointSetIntegerProperty().

AccessPointUnlock()

void AccessPointUnlock(
        word id);

This routine unlocks an access point that was previously locked.

Include: accpnt.goh

See Also: AccessPointLock().