NDC comm CompuFax User Manual

Page 110

Advertising
background image

8 6

10.1.3.9 FDB_SEND_DATA

This routine is used to send to the requestor a message that has been built with the fdb_set_* functions. If the
status returned is a success, then at least the phone number must have been set. The message is deallocated
after being sent. The user need not deallocate it.

Calling Sequence:
FDB_SEN D_DATA stream_id, message

Arguments
name: stream_id
type: longword signed
access: read only
mechanism: by reference

This is the target database stream identifier. This stream must have be open and have an unanswered lookup
request outstanding.
name: message
type: unsigned longword
access: read only
mechanism: by reference

This is the message object that was previously allocated with FDB_START_MSG.

Return Value:
FDB$_N ORMAL N ormal successful completion
FDB$_IVMSG If the message does not contain a phone number
FDB$_N OREQUEST If there is no lookup request outstanding for the stream
FDB$_N OSTREAM If the stream is not open

10.1.3.10 FDB_SET_FIELD

This routine is used to set the value of a database field in a message that was previously allocated with
fdb_start_msg. Use of this function is optional. Up to 10 different fields may be set with successive calls to
this function.

Database fields may be used in mailmerge operations to do automatic text substitution in documents at the
time the document is sent.

Field names are not case sensitive and multiple spaces and/ or tabs are reduced to a single space.

Calling Sequence:
FDB_SET_FIELD message, fieldname, fieldvalue

Arguments
name: message
type: unsigned longword
access: read only
mechanism: by reference

This is the message object that was previously allocated with fdb_start_msg.
name: fieldname
type: charactercoded text string
access: read only

Advertising