|
| |
Submit a Single File to Send
|
Input |
Output |
| AX |
CBh |
15h |
Zero
/ -Error Code |
AX |
| BX |
|
|
|
|
BX |
| CX |
|
|
|
|
CX |
| DS:DX |
Pointer
to Variable Len Ctrl |
|
|
DX |
The Submit a Single File to Send function (15H) provides a simple method of
sending a single file, either as a fax or as a file transfer. The function
creates and submits the necessary Control File and returns the
corresponding event handle (or negative error code).
Before invoking this function, you must create a data structure (described
later) that contains the appropriate information.
The file sent using this function must be in ASCII, PCX, or DCX format.
The format of the data area pointed to by DS:DX is as follows. The
individual fields have the same meaning as in a Control File.
Ofs Len Description
0 1 Transfer type:
0 - 200x200 dpi, fax mode
1 - 100x200 dpi, fax mode
2 - File transfer mode
3-127 - Reserved.
1 1 Text size (if ASCII file, fax mode)
0 - 80-column
1 - 132-column
2-127 - Reserved.
2 2 Time to send, in DOS file date and time format
4 2 Date to send, in DOS file date and time format
Note: Setting both the time and date fields to zero schedules
the file to be sent immediately. Therefore, to send a file
at once, zero the four bytes (long word) at offset 2.
6 32 Destination Name, as an ASCIIZ string (To: field)
38 80 Path and name of the file to send, as an ASCIIZ string
118 47 Phone number to call, as an ASCIIZ string
165 64 Application-specific tag field, as an ASCIIZ string
229 1 Reserved; set to zero
230 1 Cover page flag:
0 - Don't send cover page
1 - Send cover page
2-127 - Reserved
231 23 Reserved; set to zero
254 var Cover text, as an ASCIIZ string. This text is sent if the
cover page flag (offset 230) is set to 1.
You must set all fields, except for the Application-Specific Tag field,
before calling this function. However, you can set the Destination Name
and Cover Text fields to the empty string, if desired. The file is not
deleted when the event is completed.
See Also 01h Error Codes |