Returns the first message number in the message base which matches the search criteria.
Example:
integer msgno
msgno = SCANMSGHDR(0,1,HDR_TO,"Stan")
This function can be used to scan PCBoard message bases for certain information. All fields in the standard header can be searched. There are 15 fields in the standard header. Valid values for field are 1-15. See the list of constants related to this function.
| Field | hex | dec | Field Description |
| —————– | —— | —– | —————————————- |
| HDRACTIVE | 0x0E | 14 | Message active flag field | | HDRBLOCKS | 0x04 | 4 | Number of 128 byte blocks in message |
| HDRDATE | 0x05 | 5 | Date message was written | | HDRECHO | 0x0F | 15 | Echoed message flag |
| HDRFROM | 0x0B | 11 | Who the message is from | | HDRMSGNUM | 0x02 | 2 | Message number |
| HDRMSGREF | 0x03 | 3 | Reference message | | HDRPWD | 0x0D | 13 | Message password |
| HDRREPLY | 0x0A | 10 | Message reply flag | | HDRRPLYDATE | 0x08 | 8 | Reply message date |
| HDRRPLYTIME | 0x09 | 9 | Reply message time | | HDRSTATUS | 0x01 | 1 | Message status |
| HDRSUBJ | 0x0C | 12 | Message subject | | HDRTIME | 0x06 | 6 | Message time |
See also: MsgToFile