Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1100 lines
41 KiB

  1. /***************************************************************************
  2. Name : property.h
  3. Comment : Defines the properties used by Microsoft Fax
  4. Created : 10/93, from the list of WFW fax properties
  5. Author(s) : Bruce Kelley and Yoram Yaacovi
  6. Contribs :
  7. Changes : 8/2/95: documented
  8. Copyright 1993-1995 Microsoft Corporation. All Rights Reserved.
  9. ***************************************************************************/
  10. /*
  11. @doc EXTERNAL MAPI Properties OVERVIEW
  12. @topic Overview of MAPI Properties | Below you will find the list of properties that were
  13. defined and are being used by Microsoft Fax. These properties
  14. are defined in the MAPI respective ranges.<nl>
  15. <nl>
  16. <t PR_AREA_CODE>,<nl>
  17. <t PR_ATTACH_SIGNATURE>,<nl>
  18. <t PR_COUNTRY_ID>,<nl>
  19. <t PR_FAX_ACTIVE_MODEM_NAME>,<nl>
  20. <t PR_FAX_BGN_MSG_ON_COVER>,<nl>
  21. <t PR_FAX_BILLING_CODE>,<nl>
  22. <t PR_FAX_BILLING_CODE_DWORD>,<nl>
  23. <t PR_FAX_CALL_CARD_NAME>,<nl>
  24. <t PR_FAX_CHEAP_BEGIN_HOUR>,<nl>
  25. <t PR_FAX_CHEAP_BEGIN_MINUTE>,<nl>
  26. <t PR_FAX_CHEAP_END_HOUR>,<nl>
  27. <t PR_FAX_CHEAP_END_MINUTE>,<nl>
  28. <t PR_FAX_COVER_PAGE_BODY>,<nl>
  29. <t PR_FAX_CP_NAME>,<nl>
  30. <t PR_FAX_DEFAULT_COVER_PAGE>,<nl>
  31. <t PR_FAX_DELIVERY_FORMAT>,<nl>
  32. <t PR_FAX_DISPLAY_PROGRESS>,<nl>
  33. <t PR_FAX_EMBED_LINKED_OBJECTS>,<nl>
  34. <t PR_FAX_ENABLE_RECIPIENT_OPTIONS>,<nl>
  35. <t PR_FAX_ENCRYPTION_KEY>,<nl>
  36. <t PR_FAX_FAXJOB>,<nl>
  37. <t PR_FAX_IMAGE>,<nl>
  38. <t PR_FAX_IMAGE_QUALITY>,<nl>
  39. <t PR_FAX_INCLUDE_COVER_PAGE>,<nl>
  40. <t PR_FAX_LMI_CUSTOM_OPTION>,<nl>
  41. <t PR_FAX_LOGO_STRING>,<nl>
  42. <t PR_FAX_LOG_ENABLE>,<nl>
  43. <t PR_FAX_LOG_NUM_OF_CALLS>,<nl>
  44. <t PR_FAX_MAX_TIME_TO_WAIT>,<nl>
  45. <t PR_FAX_MINUTES_BETWEEN_RETRIES>,<nl>
  46. <t PR_FAX_MUST_RENDER_ALL_ATTACH>,<nl>
  47. <t PR_FAX_NETFAX_DEVICES>,<nl>
  48. <t PR_FAX_NOT_EARLIER_DATE>,<nl>
  49. <t PR_FAX_NOT_EARLIER_HOUR>,<nl>
  50. <t PR_FAX_NOT_EARLIER_MINUTE>,<nl>
  51. <t PR_FAX_NUMBER_RETRIES>,<nl>
  52. <t PR_FAX_PAPER_SIZE>,<nl>
  53. <t PR_FAX_PREVIOUS_STATE>,<nl>
  54. <t PR_FAX_PREV_BILLING_CODES>,<nl>
  55. <t PR_FAX_PRINT_HEADER>,<nl>
  56. <t PR_FAX_PRINT_ORIENTATION>,<nl>
  57. <t PR_FAX_PRINT_TO_NAME>,<nl>
  58. <t PR_FAX_PRINT_TO_PAGES>,<nl>
  59. <t PR_FAX_PRODUCT_NAME>,<nl>
  60. <t PR_FAX_PROFILE_VERSION>,<nl>
  61. <t PR_FAX_RBA_DATA>,<nl>
  62. <t PR_FAX_RECIP_CAPABILITIES>,<nl>
  63. <t PR_FAX_SECURITY_RECEIVED>,<nl>
  64. <t PR_FAX_SECURITY_SEND>,<nl>
  65. <t PR_FAX_SENDER_COUNTRY_ID>,<nl>
  66. <t PR_FAX_SENDER_EMAIL_ADDRESS>,<nl>
  67. <t PR_FAX_SENDER_NAME>,<nl>
  68. <t PR_FAX_SEND_WHEN_TYPE>,<nl>
  69. <t PR_FAX_SHARE_DEVICE>,<nl>
  70. <t PR_FAX_SHARE_NAME>,<nl>
  71. <t PR_FAX_SHARE_PATHNAME>,<nl>
  72. <t PR_FAX_TAPI_LOC_ID>,<nl>
  73. <t PR_FAX_WORK_OFF_LINE>,<nl>
  74. <t PR_HOP_INDEX>,<nl>
  75. <t PR_MAILBOX>,<nl>
  76. <t PR_MESSAGE_TYPE>,<nl>
  77. <t PR_POLLTYPE>,<nl>
  78. <t PR_POLL_RETRIEVE_PASSWORD>,<nl>
  79. <t PR_POLL_RETRIEVE_SENDME>,<nl>
  80. <t PR_POLL_RETRIEVE_TITLE>,<nl>
  81. <t PR_RECIP_INDEX>,<nl>
  82. <t PR_RECIP_VOICENUM>,<nl>
  83. <t PR_TEL_NUMBER>
  84. @xref <nl>
  85. <t MAPI Property Ranges>,<nl>
  86. <t Microsoft Fax Property Ranges>,<nl>
  87. <t Microsoft Fax Address Type>,<nl>
  88. <t Microsoft Fax Options>,<nl>
  89. <t Fax Address Book Internal Properties>,<nl>
  90. <t Scheduling Properties>,<nl>
  91. <t Retry Properties>,<nl>
  92. <t Cover Page Properties>,<nl>
  93. <t Delivery Format Properties>,<nl>
  94. <t Fax Transport Identification Properties>,<nl>
  95. <t Fax Internal Properties>,<nl>
  96. <t Fax Billing Code Properties>,<nl>
  97. <t Fax Logging Properties>,<nl>
  98. <t Fax Security Properties>,<nl>
  99. <t Fax Poll Retrieval Properties>,<nl>
  100. <t Miscellaneous IFAX Properties>
  101. */
  102. #define TRANSPORT_ENVELOPE_BASE 0x4000
  103. #define TRANSPORT_RECIP_BASE 0x5800
  104. #define USER_NON_TRANSMIT_BASE 0x6000
  105. #define PROVIDER_INTERNAL_NON_TRANSMIT_BASE 0x6600
  106. #define MESSAGE_CLASS_CONTENT_BASE 0x6800
  107. #define MESSAGE_CLASS_NON_TRANSMIT_BASE 0x7C00
  108. /*
  109. @doc EXTERNAL PROPERTIES
  110. @subtopic MAPI Property Ranges | The list below was taken from
  111. mapitags.h in the MAPI SDK. It represents the property ranges
  112. as defined by MAPI.
  113. From To Kind of property<nl>
  114. ----------------------------------------------------------<nl>
  115. 0001 0BFF MAPI_defined envelope property<nl>
  116. 0C00 0DFF MAPI_defined per-recipient property<nl>
  117. 0E00 0FFF MAPI_defined non-transmittable property<nl>
  118. 1000 2FFF MAPI_defined message content property<nl>
  119. 3000 3FFF MAPI_defined property (usually not message or
  120. recipient)<nl>
  121. 4000 57FF Transport-defined envelope property<nl>
  122. 5800 5FFF Transport-defined per-recipient property<nl>
  123. 6000 65FF User-defined non-transmittable property<nl>
  124. 6600 67FF Provider-defined internal non-transmittable
  125. property<nl>
  126. 6800 7BFF Message class-defined content property<nl>
  127. 7C00 7FFF Message class-defined non-transmittable
  128. property<nl>
  129. 8000 FFFE User-defined Name-to-id mapped property<nl>
  130. The 3000-3FFF range is further subdivided as follows:<nl>
  131. From To Kind of property<nl>
  132. ------------------------------------------------------------<nl>
  133. 3000 33FF Common property such as display name, entry ID<nl>
  134. 3400 35FF Message store object<nl>
  135. 3600 36FF Folder or AB container<nl>
  136. 3700 38FF Attachment<nl>
  137. 3900 39FF Address book object<nl>
  138. 3A00 3BFF Mail user<nl>
  139. 3C00 3CFF Distribution list<nl>
  140. 3D00 3DFF Profile section<nl>
  141. 3E00 3FFF Status object
  142. @subtopic Microsoft Fax Property Ranges | Microsoft Fax further defines
  143. property ranges within the MAPI property ranges in which the
  144. fax properties are defined. Some offset off the MAPI property
  145. range was used to reduce the possibility of collision with
  146. properties defined by other MAPI transports.<nl>
  147. EFAX_MESSAGE_BASE:<nl>
  148. Starting property ID for fax message properties<nl>
  149. EFAX_RECIPIENT_BASE:<nl>
  150. Starting property ID for fax recipient properties<nl>
  151. EFAX_OPTIONS_BASE:<nl>
  152. Starting property ID for fax properties (options) which
  153. are not transmittable. These properties are used for fax
  154. setup and are not message or recipient related.
  155. Example: current active fax device.
  156. */
  157. #define EFAX_MESSAGE_BASE TRANSPORT_ENVELOPE_BASE + 0x500
  158. #define EFAX_RECIPIENT_BASE TRANSPORT_RECIP_BASE + 0x100
  159. #define EFAX_OPTIONS_BASE PROVIDER_INTERNAL_NON_TRANSMIT_BASE + 0x100
  160. /*
  161. @doc EXTERNAL PROPERTIES
  162. @subtopic Microsoft Fax Address Type | Microsoft Fax's address type is "FAX".
  163. It has major importance, in the sense that the Microsoft Fax
  164. transport will only handle recipients that have this address
  165. type in their PR_ADDRTYPE.
  166. */
  167. #define EFAX_ADDR_TYPE "FAX"
  168. /*
  169. @doc EXTERNAL PROPERTIES
  170. @subtopic Microsoft Fax Options | Microsoft Fax defines some properties
  171. that control the way the fax product operates. These properties
  172. are mostly fax configuration properties and are stored in the
  173. fax transport section in the MAPI profile.<nl>
  174. <nl>
  175. <t PR_FAX_ACTIVE_MODEM_NAME><nl>
  176. <t PR_FAX_WORK_OFF_LINE><nl>
  177. <t PR_FAX_SHARE_DEVICE><nl>
  178. <t PR_FAX_SHARE_NAME><nl>
  179. <t PR_FAX_SENDER_COUNTRY_ID><nl>
  180. <t PR_FAX_NETFAX_DEVICES><nl>
  181. <t PR_FAX_SHARE_PATHNAME><nl>
  182. <t Scheduling Properties><nl>
  183. <t Retry Properties><nl>
  184. <t Cover Page Properties><nl>
  185. <t Delivery Format Properties><nl>
  186. <t PR_FAX_BGN_MSG_ON_COVER><nl>
  187. <t PR_FAX_TAPI_LOC_ID><nl>
  188. <t Fax Security Properties><nl>
  189. <t Fax Poll Retrieval Properties>
  190. */
  191. /*
  192. @doc EXTERNAL PROPERTIES
  193. @prop PR_FAX_PRODUCT_NAME |
  194. Name of the fax product. Used for profile validity
  195. verification.
  196. @comm Settable through UI: Yes
  197. */
  198. #define PR_FAX_PRODUCT_NAME PROP_TAG(PT_TSTRING, (EFAX_OPTIONS_BASE + 0x0))
  199. /*
  200. @doc EXTERNAL PROPERTIES
  201. @prop PR_FAX_ACTIVE_MODEM_NAME |
  202. Name of the currently active faxing device. There can be
  203. only one active fax device at a time. The name has the
  204. following format:<nl>
  205. <lt>name-or-identifier<gt>:<lt>DLL-name<gt><nl>
  206. <nl>
  207. Where:<nl>
  208. <lt>name-or-identifier<gt> is the name of the active
  209. device. The name can be anything, and is
  210. meaningful only for the LMI provider that
  211. handles this device.<nl>
  212. <nl>
  213. <lt>DLL-name<gt> is the name of the DLL that handles
  214. this device. This DLL must export the LMI
  215. interface. See the LMI doc for details.<nl>
  216. @ex When the active device is a netfax device, the
  217. name will be something like: |
  218. \\faxserver\netfax:awnfax32.dll
  219. @comm Settable through UI: Yes
  220. */
  221. #define PR_FAX_ACTIVE_MODEM_NAME PROP_TAG(PT_TSTRING, (EFAX_OPTIONS_BASE + 0x1))
  222. /*
  223. @doc EXTERNAL PROPERTIES
  224. @prop PR_FAX_WORK_OFF_LINE |
  225. If TRUE, the Microsoft Fax transport will work offline,
  226. i.e. it will not kick off the LMI provider for the active
  227. fax device.
  228. @comm Settable through UI: No
  229. */
  230. #define PR_FAX_WORK_OFF_LINE PROP_TAG(PT_BOOLEAN, (EFAX_OPTIONS_BASE + 0x2))
  231. /*
  232. @doc EXTERNAL PROPERTIES
  233. @prop PR_FAX_SHARE_DEVICE |
  234. If TRUE, the user selected to share his active fax
  235. device so that others can fax through it.
  236. @comm Settable through UI: Yes
  237. */
  238. #define PR_FAX_SHARE_DEVICE PROP_TAG(PT_BOOLEAN, (EFAX_OPTIONS_BASE + 0x3))
  239. /*
  240. @doc EXTERNAL PROPERTIES
  241. @prop PR_FAX_SHARE_NAME |
  242. If sharing is enabled, this is the name of the share
  243. that users will use to connect and send faxes through
  244. the active fax device on this machine.
  245. @comm Settable through UI: Yes
  246. */
  247. #define PR_FAX_SHARE_NAME PROP_TAG(PT_TSTRING, (EFAX_OPTIONS_BASE + 0x4))
  248. /*
  249. @doc EXTERNAL PROPERTIES
  250. @prop PR_FAX_SENDER_COUNTRY_ID |
  251. This property is used internally by the fax
  252. configuration code to store the country ID of the sender.
  253. There is no guarantee that this property will have the
  254. appropriate country ID in the profile.
  255. @comm Settable through UI: No
  256. */
  257. #define PR_FAX_SENDER_COUNTRY_ID PROP_TAG(PT_LONG, (EFAX_OPTIONS_BASE + 0x5))
  258. /*
  259. @doc EXTERNAL PROPERTIES
  260. @prop PR_FAX_NETFAX_DEVICES |
  261. The name of this property is somewhat misleading. This
  262. property is a MAPI multi-value property that stores the
  263. names of the "other" devices the user added to his list
  264. of available devices. These "other" devices include,
  265. but are not limited to, netfax devices.
  266. @comm Settable through UI: Yes
  267. */
  268. #define PR_FAX_NETFAX_DEVICES PROP_TAG(PT_MV_STRING8, (EFAX_OPTIONS_BASE + 0x6))
  269. /*
  270. @doc EXTERNAL PROPERTIES
  271. @prop PR_FAX_SHARE_PATHNAME |
  272. Pathname of the shared fax directory on the sharing
  273. machine. Don't confuse this with the share name,
  274. PR_FAX_SHARE_NAME; this is the full pathname to the
  275. shared directory on the sharing machine, and not the
  276. name clients will use to connect to this share.
  277. @comm Settable through UI: No
  278. */
  279. #define PR_FAX_SHARE_PATHNAME PROP_TAG(PT_TSTRING, (EFAX_OPTIONS_BASE + 0x7))
  280. /*
  281. @doc EXTERNAL PROPERTIES
  282. @prop PR_FAX_PROFILE_VERSION |
  283. The version of the Microsoft Fax transport section in
  284. the MAPI profile. Set to 0x00000001 in Windows 95.
  285. @comm Settable through UI: No
  286. */
  287. #define PR_FAX_PROFILE_VERSION PROP_TAG(PT_LONG, (EFAX_OPTIONS_BASE + 0x8))
  288. /*
  289. @doc EXTERNAL PROPERTIES
  290. @subtopic Fax Address Book Internal Properties | These properties
  291. are used internally by the fax address book provider to
  292. store the components of a fax address in the wrapped
  293. fax address book entry.<nl>
  294. <t PR_MAILBOX><nl>
  295. <t PR_COUNTRY_ID><nl>
  296. <t PR_AREA_CODE><nl>
  297. <t PR_TEL_NUMBER>
  298. @comm These should probably have been offsets off EFAX_OPTIONS_BASE, but it's
  299. too late to change now.
  300. @comm Settable through UI: Yes<nl>
  301. */
  302. /*
  303. @doc EXTERNAL PROPERTIES
  304. @prop PR_COUNTRY_ID |
  305. The user's return fax number country code.
  306. @comm Settable through UI: Yes
  307. */
  308. #define PR_COUNTRY_ID PROP_TAG(PT_LONG,PROVIDER_INTERNAL_NON_TRANSMIT_BASE + 0x7)
  309. /*
  310. @doc EXTERNAL PROPERTIES
  311. @prop PR_AREA_CODE |
  312. The user's return fax number area code.
  313. @comm Settable through UI: Yes
  314. */
  315. #define PR_AREA_CODE PROP_TAG(PT_STRING8,PROVIDER_INTERNAL_NON_TRANSMIT_BASE + 0x8)
  316. /*
  317. @doc EXTERNAL PROPERTIES
  318. @prop PR_TEL_NUMBER |
  319. The user's return fax number.
  320. @comm Settable through UI: Yes
  321. */
  322. #define PR_TEL_NUMBER PROP_TAG(PT_STRING8,PROVIDER_INTERNAL_NON_TRANSMIT_BASE + 0x9)
  323. /*
  324. @doc EXTERNAL PROPERTIES
  325. @prop PR_MAILBOX |
  326. A routing mailbox for the user's return fax number.
  327. @comm Settable through UI: Yes
  328. */
  329. #define PR_MAILBOX PROP_TAG(PT_STRING8,PROVIDER_INTERNAL_NON_TRANSMIT_BASE + 0xa)
  330. //
  331. // Non-Transmittable message properties
  332. //
  333. /*
  334. @doc EXTERNAL PROPERTIES
  335. @subtopic Scheduling Properties | These properties are used to specify
  336. the cheap times or the time to send. The hour goes in the HOUR
  337. property, the MINUTE goes into the MINUTE property. If you set
  338. PR_FAX_CHEAP_BEGIN_* you must also set PR_FAX_CHEAP_END_*.
  339. PR_FAX_NOT_EARLIER_DATE is currently not used. Setting
  340. PR_FAX_SEND_WHEN_TYPE determines which of these properties to
  341. use. If it is set to SEND_ASAP or is absent, they are all
  342. ignored. If it is set to SEND_CHEAP, we will use the
  343. PR_FAX_CHEAP_* properties. If it is set to SEND_AT_TIME, we
  344. will use PR_FAX_NOT_EARLIER_*.<nl>
  345. <t PR_FAX_CHEAP_BEGIN_HOUR><nl>
  346. <t PR_FAX_CHEAP_BEGIN_MINUTE><nl>
  347. <t PR_FAX_CHEAP_END_HOUR><nl>
  348. <t PR_FAX_CHEAP_END_MINUTE><nl>
  349. <t PR_FAX_NOT_EARLIER_HOUR><nl>
  350. <t PR_FAX_NOT_EARLIER_MINUTE><nl>
  351. <t PR_FAX_NOT_EARLIER_DATE>
  352. @comm Settable through UI: Yes
  353. */
  354. /*
  355. @doc EXTERNAL PROPERTIES
  356. @prop PR_FAX_CHEAP_BEGIN_HOUR |
  357. The hour portion of start of the "cheap times" interval beginning time.
  358. @comm Settable through UI: Yes
  359. */
  360. #define PR_FAX_CHEAP_BEGIN_HOUR PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x1))
  361. /*
  362. @doc EXTERNAL PROPERTIES
  363. @prop PR_FAX_CHEAP_BEGIN_MINUTE |
  364. The minute portion of start of the "cheap times" interval beginning time.
  365. @comm Settable through UI: Yes
  366. */
  367. #define PR_FAX_CHEAP_BEGIN_MINUTE PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x2))
  368. /*
  369. @doc EXTERNAL PROPERTIES
  370. @prop PR_FAX_CHEAP_END_HOUR |
  371. The hour portion of start of the "cheap times" interval ending time.
  372. @comm Settable through UI: Yes
  373. */
  374. #define PR_FAX_CHEAP_END_HOUR PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x3))
  375. /*
  376. @doc EXTERNAL PROPERTIES
  377. @prop PR_FAX_CHEAP_END_MINUTE |
  378. The minute portion of start of the "cheap times" interval ending time.
  379. @comm Settable through UI: Yes
  380. */
  381. #define PR_FAX_CHEAP_END_MINUTE PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x4))
  382. /*
  383. @doc EXTERNAL PROPERTIES
  384. @prop PR_FAX_NOT_EARLIER_HOUR |
  385. The hour portion of start of the "send at" time.
  386. @comm Settable through UI: Yes
  387. */
  388. #define PR_FAX_NOT_EARLIER_HOUR PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x5))
  389. /*
  390. @doc EXTERNAL PROPERTIES
  391. @prop PR_FAX_NOT_EARLIER_MINUTE |
  392. The minute portion of start of the "send at" time.
  393. @comm Settable through UI: Yes
  394. */
  395. #define PR_FAX_NOT_EARLIER_MINUTE PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x6))
  396. /*
  397. @doc EXTERNAL PROPERTIES
  398. @prop PR_FAX_NOT_EARLIER_DATE |
  399. The date portion of start of the "send at" time.
  400. @comm Settable through UI: Not Yet
  401. @comm This feature is not yet implemented.
  402. */
  403. #define PR_FAX_NOT_EARLIER_DATE PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x7))
  404. /*
  405. @doc EXTERNAL PROPERTIES
  406. @subtopic Retry Properties | These properties specify the retry
  407. behavior if the dialed fax number is busy.<nl>
  408. <t PR_FAX_NUMBER_RETRIES><nl>
  409. <t PR_FAX_MINUTES_BETWEEN_RETRIES>
  410. @comm Settable through UI: Yes
  411. */
  412. /*
  413. @doc EXTERNAL PROPERTIES
  414. @prop PR_FAX_NUMBER_RETRIES |
  415. The number of times to retry a busy fax number. If 0, only one attempt will
  416. be made before an NDR is generated.
  417. @comm Settable through UI: Yes
  418. */
  419. #define PR_FAX_NUMBER_RETRIES PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x8))
  420. /*
  421. @doc EXTERNAL PROPERTIES
  422. @prop PR_FAX_MINUTES_BETWEEN_RETRIES |
  423. The number of minutes to wait before retrying a busy fax number.
  424. @comm Settable through UI: Yes
  425. */
  426. #define PR_FAX_MINUTES_BETWEEN_RETRIES PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x9))
  427. /*
  428. @doc EXTERNAL PROPERTIES
  429. @subtopic Cover Page Properties | These properties specify cover page
  430. behavior.<nl>
  431. <t PR_FAX_INCLUDE_COVER_PAGE><nl>
  432. <t PR_FAX_COVER_PAGE_BODY><nl>
  433. <t PR_FAX_BGN_MSG_ON_COVER><nl>
  434. <t PR_FAX_DEFAULT_COVER_PAGE>
  435. @comm Settable through UI: Yes
  436. */
  437. /*
  438. @doc EXTERNAL PROPERTIES
  439. @prop PR_FAX_INCLUDE_COVER_PAGE |
  440. If set to TRUE, we will include a cover page IF this fax is sent as Not Editable.
  441. @comm Settable through UI: Yes
  442. */
  443. #define PR_FAX_INCLUDE_COVER_PAGE PROP_TAG(PT_BOOLEAN, (EFAX_MESSAGE_BASE + 0xA))
  444. /*
  445. @doc EXTERNAL PROPERTIES
  446. @prop PR_FAX_COVER_PAGE_BODY |
  447. This property is obsolete.
  448. @comm Settable through UI: No
  449. */
  450. #define PR_FAX_COVER_PAGE_BODY PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0xB))
  451. /*
  452. @doc EXTERNAL PROPERTIES
  453. @prop PR_FAX_LOGO_STRING |
  454. This property is obsolete.
  455. */
  456. #define PR_FAX_LOGO_STRING PROP_TAG(PT_STRING8, (EFAX_MESSAGE_BASE + 0xC))
  457. /*
  458. @doc EXTERNAL PROPERTIES
  459. @subtopic Delivery Format Properties | These properties override the
  460. default delivery format behavior.<nl>
  461. <t PR_FAX_DELIVERY_FORMAT><nl>
  462. <t PR_FAX_PRINT_ORIENTATION><nl>
  463. <t PR_FAX_PAPER_SIZE><nl>
  464. <t PR_FAX_IMAGE_QUALITY>
  465. */
  466. /*
  467. @doc EXTERNAL PROPERTIES
  468. @prop PR_FAX_DELIVERY_FORMAT |
  469. Determines whether this fax should be sent SEND_EDITABLE,
  470. SEND_PRINTED or SEND_BEST.
  471. @xref <t PR_FAX_DELIVERY_FORMAT Values>
  472. @comm Settable through UI: Yes
  473. */
  474. #define PR_FAX_DELIVERY_FORMAT PROP_TAG(PT_LONG, (EFAX_MESSAGE_BASE + 0xD))
  475. /*
  476. @doc EXTERNAL PROPERTIES
  477. @prop PR_FAX_PRINT_ORIENTATION |
  478. Determines the orientation for the message body and for attachments
  479. which don't have their own idea what orientation to print in.
  480. @xref <t PR_FAX_PRINT_ORIENTATION Values>
  481. @comm Settable through UI: Yes
  482. */
  483. #define PR_FAX_PRINT_ORIENTATION PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0xE))
  484. /*
  485. @doc EXTERNAL PROPERTIES
  486. @prop PR_FAX_PAPER_SIZE |
  487. Determines what size page should be rendered.
  488. @xref <t PR_FAX_PAPER_SIZE Values>
  489. @comm Settable through UI: Yes
  490. */
  491. #define PR_FAX_PAPER_SIZE PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0xF))
  492. /*
  493. @doc EXTERNAL PROPERTIES
  494. @prop PR_FAX_IMAGE_QUALITY |
  495. Determines the image quality to render, ie, Standard (100x200),
  496. Fine (200x200), or 300 Dpi.
  497. @xref <t PR_FAX_IMAGE_QUALITY Values>
  498. @comm Settable through UI: Yes
  499. */
  500. #define PR_FAX_IMAGE_QUALITY PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x10))
  501. /*
  502. @doc EXTERNAL PROPERTIES
  503. @subtopic Fax Transport Identification Properties | These properties
  504. set the identification of the sender on the message.
  505. These properties should not be modified outside of the transport.<nl>
  506. <t PR_FAX_SENDER_NAME><nl>
  507. <t PR_FAX_SENDER_EMAIL_ADDRESS>
  508. @comm Settable through UI: Indirectly
  509. */
  510. /*
  511. @doc EXTERNAL PROPERTIES
  512. @prop PR_FAX_SENDER_NAME |
  513. This message property identifies Microsoft Fax transport's idea of the
  514. sender of the message. This property is copied from the profile's
  515. PR_SENDER_NAME and is the display name of the sender.
  516. This property should not be modified outside of the transport.
  517. @comm Settable through UI: Indirectly
  518. */
  519. #define PR_FAX_SENDER_NAME PROP_TAG(PT_STRING8, (EFAX_MESSAGE_BASE + 0x11))
  520. /*
  521. @doc EXTERNAL PROPERTIES
  522. @prop PR_FAX_SENDER_EMAIL_ADDRESS |
  523. This message property identifies Microsoft Fax transport's idea of the
  524. sender of the message. This property is copied from the profile's
  525. PR_SENDER_EMAIL_ADDRESS and is the fax address (number) of the sender.
  526. This property should not be modified outside of the transport.
  527. @comm Settable through UI: Indirectly
  528. */
  529. #define PR_FAX_SENDER_EMAIL_ADDRESS PROP_TAG(PT_STRING8, (EFAX_MESSAGE_BASE + 0x12))
  530. /*
  531. @doc EXTERNAL PROPERTIES
  532. @prop PR_FAX_LMI_CUSTOM_OPTION |
  533. This property allows a block of data to be sent directly from the MAPI
  534. client down to the LMI provider. This is specifically designed to allow
  535. for communication from an LMI custom property page to communicate it's
  536. per-message settings to the LMI. See the LMI help file for more
  537. information.
  538. @comm Settable through UI: No
  539. */
  540. #define PR_FAX_LMI_CUSTOM_OPTION PROP_TAG(PT_BINARY, (EFAX_MESSAGE_BASE + 0x13))
  541. /*
  542. @doc EXTERNAL PROPERTIES
  543. @subtopic Fax Internal Properties | These two properties are internal to
  544. the fax transport and should not be modified.<nl>
  545. <t PR_FAX_PREVIOUS_STATE><nl>
  546. <t PR_FAX_FAXJOB>
  547. Settable through UI: No
  548. */
  549. /*
  550. @doc EXTERNAL PROPERTIES
  551. @prop PR_FAX_PREVIOUS_STATE |
  552. This property is internal to the fax transport and should not be modified.
  553. @comm Settable through UI: No
  554. */
  555. #define PR_FAX_PREVIOUS_STATE PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x14))
  556. /*
  557. @doc EXTERNAL PROPERTIES
  558. @prop PR_FAX_FAXJOB |
  559. This property maintains the current state of a sent fax.
  560. It is removed when the job has been sent or NDR'd.
  561. This property is internal to the fax transport and should not be modified.
  562. @comm Settable through UI: No
  563. */
  564. #define PR_FAX_FAXJOB PROP_TAG(PT_BINARY, (EFAX_MESSAGE_BASE + 0x15))
  565. /*
  566. @doc EXTERNAL PROPERTIES
  567. @subtopic Fax Billing Code Properties | A billing code can be associated
  568. with a message. This feature is not yet implemented.<nl>
  569. <t PR_FAX_BILLING_CODE><nl>
  570. <t PR_FAX_PREV_BILLING_CODES><nl>
  571. <t PR_FAX_BILLING_CODE_DWORD>
  572. @comm Settable through UI: Not Yet.
  573. */
  574. /*
  575. @doc EXTERNAL PROPERTIES
  576. @prop PR_FAX_BILLING_CODE |
  577. A billing code can be associated with a message. This property contains
  578. the ASCII equivalent of PR_FAX_BILLING_CODE_DWORD and might be dropped in
  579. future.
  580. This feature is not yet implemented.
  581. @comm Settable through UI: Not Yet.
  582. */
  583. #define PR_FAX_BILLING_CODE PROP_TAG(PT_STRING8, (EFAX_MESSAGE_BASE + 0x16))
  584. /*
  585. @doc EXTERNAL PROPERTIES
  586. @prop PR_FAX_PREV_BILLING_CODES |
  587. This is property is for internal use and is subject to change in the future.
  588. It is a multi-value MAPI property that contains the list of the last 10
  589. billing codes that the user used.
  590. This feature is not yet implemented.
  591. @comm Settable through UI: Not Yet.
  592. */
  593. #define PR_FAX_PREV_BILLING_CODES PROP_TAG(PT_MV_STRING8, (EFAX_MESSAGE_BASE + 0x17))
  594. /*
  595. @doc EXTERNAL PROPERTIES
  596. @prop PR_FAX_BGN_MSG_ON_COVER |
  597. Set TRUE if the message should start on the cover page. This is ignored
  598. if there is no cover page generated. All Rich Text formatting of the message
  599. body is lost when this feature is used.
  600. @comm Settable through UI: Yes
  601. */
  602. #define PR_FAX_BGN_MSG_ON_COVER PROP_TAG(PT_BOOLEAN, (EFAX_MESSAGE_BASE + 0x18))
  603. /*
  604. @doc EXTERNAL PROPERTIES
  605. @prop PR_FAX_SEND_WHEN_TYPE |
  606. Defines how the fax should be scheduled in concert with the Fax
  607. Scheduling Properties.
  608. @comm Settable through UI: Yes
  609. */
  610. #define PR_FAX_SEND_WHEN_TYPE PROP_TAG(PT_LONG, (EFAX_MESSAGE_BASE + 0x19))
  611. /*
  612. @doc EXTERNAL PROPERTIES
  613. @prop PR_FAX_DEFAULT_COVER_PAGE |
  614. Defines which cover page template to use. Must contain the
  615. full pathname of the file.
  616. @comm Settable through UI: Yes
  617. */
  618. #define PR_FAX_DEFAULT_COVER_PAGE PROP_TAG(PT_STRING8, (EFAX_MESSAGE_BASE + 0x1A))
  619. /*
  620. @doc EXTERNAL PROPERTIES
  621. @prop PR_FAX_MAX_TIME_TO_WAIT |
  622. Maximum Time to wait for connection (seconds).
  623. This property is obsolete.
  624. */
  625. #define PR_FAX_MAX_TIME_TO_WAIT PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x1B))
  626. /*
  627. @doc EXTERNAL PROPERTIES
  628. @subtopic Fax Logging Properties | Define behavior of call logging
  629. feature.
  630. This feature is not yet implemented.<nl>
  631. <t PR_FAX_LOG_ENABLE><nl>
  632. <t PR_FAX_LOG_NUM_OF_CALLS>
  633. @comm Settable through UI: Not Yet
  634. */
  635. /*
  636. @doc EXTERNAL PROPERTIES
  637. @prop PR_FAX_LOG_ENABLE |
  638. Turn on or off the call logging feature.
  639. This feature is not yet implemented.
  640. @comm Settable through UI: Not Yet.
  641. */
  642. #define PR_FAX_LOG_ENABLE PROP_TAG(PT_BOOLEAN, (EFAX_MESSAGE_BASE + 0x1C))
  643. /*
  644. @doc EXTERNAL PROPERTIES
  645. @prop PR_FAX_LOG_NUM_OF_CALLS |
  646. The number of calls that call logging should keep track of.
  647. This feature is not yet implemented.
  648. @comm Settable through UI: Not Yet.
  649. */
  650. #define PR_FAX_LOG_NUM_OF_CALLS PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x1D))
  651. /*
  652. @doc EXTERNAL PROPERTIES
  653. @prop PR_FAX_DISPLAY_PROGRESS |
  654. This property is not used at this time.
  655. */
  656. // Display call progress
  657. #define PR_FAX_DISPLAY_PROGRESS PROP_TAG(PT_BOOLEAN, (EFAX_MESSAGE_BASE + 0x1E))
  658. /*
  659. @doc EXTERNAL PROPERTIES
  660. @prop PR_FAX_EMBED_LINKED_OBJECTS |
  661. This property is set TRUE if the transport should convert linked
  662. objects to static objects before sending.
  663. @comm This feature is not yet implemented.
  664. @comm Settable through UI: Not Yet
  665. */
  666. #define PR_FAX_EMBED_LINKED_OBJECTS PROP_TAG(PT_BOOLEAN, (EFAX_MESSAGE_BASE + 0x1F))
  667. /*
  668. @doc EXTERNAL PROPERTIES
  669. @prop PR_FAX_TAPI_LOC_ID |
  670. This property is used to store the TAPI location ID associated with
  671. this profile. It is currently not used, i.e. we always use the default
  672. TAPI location
  673. @comm Settable through UI: No
  674. */
  675. #define PR_FAX_TAPI_LOC_ID PROP_TAG(PT_LONG, (EFAX_MESSAGE_BASE + 0x20))
  676. /*
  677. @doc EXTERNAL PROPERTIES
  678. @prop PR_FAX_MUST_RENDER_ALL_ATTACH |
  679. This property is not used at this time.
  680. */
  681. #define PR_FAX_MUST_RENDER_ALL_ATTACH PROP_TAG(PT_BOOLEAN, (EFAX_MESSAGE_BASE + 0x21))
  682. /*
  683. @doc EXTERNAL PROPERTIES
  684. @prop PR_FAX_ENABLE_RECIPIENT_OPTIONS |
  685. This property is set TRUE if per-recipient options are desired.
  686. @comm This feature is not yet implemented.
  687. @comm Settable through UI: Not Yet
  688. */
  689. #define PR_FAX_ENABLE_RECIPIENT_OPTIONS PROP_TAG(PT_BOOLEAN, (EFAX_MESSAGE_BASE + 0x22))
  690. /*
  691. @doc EXTERNAL PROPERTIES
  692. @prop PR_FAX_CALL_CARD_NAME |
  693. This property defines what calling card should be used for this call.
  694. @comm This feature is not yet implemented.
  695. @comm Settable through UI: Not Yet
  696. */
  697. #define PR_FAX_CALL_CARD_NAME PROP_TAG(PT_STRING8, (EFAX_MESSAGE_BASE + 0x24))
  698. /*
  699. @doc EXTERNAL PROPERTIES
  700. @prop PR_FAX_PRINT_TO_NAME |
  701. This property defines the RBA data stream placed on the message
  702. or attachment. It is internal to Microsoft Fax and should not
  703. be modified.
  704. @comm Settable through UI: No
  705. */
  706. #define PR_FAX_PRINT_TO_NAME PROP_TAG(PT_STRING8, (EFAX_MESSAGE_BASE + 0x25))
  707. /*
  708. @doc EXTERNAL PROPERTIES
  709. @subtopic Fax Security Properties |
  710. ??? <nl>
  711. <t PR_FAX_SECURITY_SEND><nl>
  712. <t PR_FAX_SECURITY_RECEIVED><nl>
  713. <t PR_ATTACH_SIGNATURE><nl>
  714. <t PR_FAX_ENCRYPTION_KEY>
  715. */
  716. /*
  717. @doc EXTERNAL PROPERTIES
  718. @prop PR_FAX_SECURITY_SEND |
  719. ???
  720. @comm Settable through UI: ??
  721. */
  722. #define PR_FAX_SECURITY_SEND PROP_TAG(PT_BINARY, (EFAX_MESSAGE_BASE + 0x26))
  723. /*
  724. @doc EXTERNAL PROPERTIES
  725. @prop PR_FAX_SECURITY_RECEIVED |
  726. ???
  727. @comm Settable through UI: ??
  728. */
  729. #define PR_FAX_SECURITY_RECEIVED PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x27))
  730. /*
  731. @doc EXTERNAL PROPERTIES
  732. @prop PR_FAX_RBA_DATA |
  733. This property defines the RBA data stream placed on a print-to-fax
  734. message. It is internal to Microsoft Fax and should not be modified.
  735. @comm Settable through UI: No
  736. */
  737. #define PR_FAX_RBA_DATA PROP_TAG(PT_BINARY, (EFAX_MESSAGE_BASE + 0x28))
  738. /*
  739. @doc EXTERNAL PROPERTIES
  740. @subtopic Fax Poll Retrieval Properties | These properties define the
  741. behavior of a poll retrieve request. If <t PR_POLL_RETRIEVE_SENDME>
  742. is SENDME_DEFAULT the default document will be polled from the
  743. dialed fax. Otherwise, we will poll for the document named in
  744. <t PR_POLL_RETRIEVE_TITLE> with the optional password specified in
  745. <t PR_POLL_RETRIEVE_PASSWORD>. <t PR_POLLTYPE> is obsolete.
  746. @xref <t PR_POLL_RETRIEVE_SENDME Values>
  747. @comm Settable through UI: Yes
  748. */
  749. /*
  750. @doc EXTERNAL PROPERTIES
  751. @prop PR_POLL_RETRIEVE_SENDME |
  752. If this property contains <t SENDME_DEFAULT>, the default document will be polled
  753. from the dialed fax number. Otherwise we will poll for the document named in
  754. <t PR_POLL_RETRIEVE_TITLE> with the optional password specified in
  755. <t PR_POLL_RETRIEVE_PASSWORD>.
  756. @xref <t PR_POLL_RETRIEVE_SENDME Values>
  757. @comm Settable through UI: Yes
  758. */
  759. #define PR_POLL_RETRIEVE_SENDME PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x29))
  760. /*
  761. @doc EXTERNAL PROPERTIES
  762. @prop PR_POLL_RETRIEVE_TITLE |
  763. Contains the title of the document to retrive in a polling call.
  764. @comm Settable through UI: Yes
  765. */
  766. #define PR_POLL_RETRIEVE_TITLE PROP_TAG(PT_TSTRING, (EFAX_MESSAGE_BASE + 0x30))
  767. /*
  768. @doc EXTERNAL PROPERTIES
  769. @prop PR_POLL_RETRIEVE_PASSWORD |
  770. Contains the password to use in a polling call.
  771. @comm Settable through UI: Yes
  772. */
  773. #define PR_POLL_RETRIEVE_PASSWORD PROP_TAG(PT_TSTRING, (EFAX_MESSAGE_BASE + 0x31))
  774. /*
  775. @doc EXTERNAL PROPERTIES
  776. @prop PR_POLLTYPE |
  777. This property is obsolete.
  778. @comm Settable through UI: No
  779. */
  780. #define PR_POLLTYPE PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x32))
  781. /*
  782. @doc EXTERNAL PROPERTIES
  783. @prop PR_MESSAGE_TYPE |
  784. This property is used by the poll server.
  785. @comm This feature is not yet implemented.
  786. */
  787. #define PR_MESSAGE_TYPE PROP_TAG(PT_I2, (EFAX_MESSAGE_BASE + 0x33))
  788. /*
  789. @doc EXTERNAL PROPERTIES
  790. @prop PR_ATTACH_SIGNATURE |
  791. This property contains the encrypted digital signature for an attachment.
  792. @comm Settable through UI: Indirectly
  793. */
  794. #define PR_ATTACH_SIGNATURE PROP_TAG(PT_BINARY, (EFAX_MESSAGE_BASE + 0x34))
  795. /*
  796. @doc EXTERNAL PROPERTIES
  797. @prop PR_FAX_PRINT_TO_PAGES |
  798. This property is set during the Print-to-Fax operation and contains the
  799. number of pages printed for use on the cover page. This is internal to
  800. Microsoft Fax and should not be modified.
  801. @comm Settable through UI: No
  802. */
  803. #define PR_FAX_PRINT_TO_PAGES PROP_TAG(PT_LONG, (EFAX_MESSAGE_BASE + 0x35))
  804. /*
  805. @doc EXTERNAL PROPERTIES
  806. @prop PR_FAX_IMAGE |
  807. This property is set on an incoming linearized image message and contains
  808. the image data prior to conversion to RBA. This property is internal to
  809. Microsoft Fax and should not be modified.
  810. @comm Settable through UI: No
  811. */
  812. #define PR_FAX_IMAGE PROP_TAG(PT_BINARY, (EFAX_MESSAGE_BASE + 0x36))
  813. /*
  814. @doc EXTERNAL PROPERTIES
  815. @prop PR_FAX_PRINT_HEADER |
  816. This property controls branding of G3 faxed pages.
  817. @comm This feature is not yet implemented.
  818. @comm Settable through UI: Not Yet
  819. */
  820. #define PR_FAX_PRINT_HEADER PROP_TAG(PT_BOOLEAN, (EFAX_MESSAGE_BASE + 0x37))
  821. /*
  822. @doc EXTERNAL PROPERTIES
  823. @prop PR_FAX_BILLING_CODE_DWORD |
  824. This is the DWORD representation of the billing code. This
  825. is the representation that will be tacked to a message.
  826. @comm This feature is not yet implemented.
  827. @comm Settable through UI: Not Yet.
  828. */
  829. #define PR_FAX_BILLING_CODE_DWORD PROP_TAG(PT_LONG, (EFAX_MESSAGE_BASE + 0x38))
  830. /*
  831. @doc EXTERNAL PROPERTIES
  832. @subtopic Miscellaneous IFAX Properties | These Non-Transmittable
  833. Mail-User properties are internal to Microsoft Fax or are
  834. obsolete. Do not use or rely on them.<nl>
  835. <t PR_FAX_RECIP_CAPABILITIES><nl>
  836. <t PR_FAX_CP_NAME><nl>
  837. <t PR_RECIP_INDEX><nl>
  838. <t PR_HOP_INDEX><nl>
  839. <t PR_RECIP_VOICENUM>
  840. */
  841. /*
  842. @doc EXTERNAL PROPERTIES
  843. @prop PR_FAX_RECIP_CAPABILITIES |
  844. May be set on a received fax if the sender sent it.
  845. This is currently only sent by IFAX.
  846. @comm Settable through UI: No
  847. */
  848. #define PR_FAX_RECIP_CAPABILITIES PROP_TAG(PT_I2, (EFAX_RECIPIENT_BASE + 0x0))
  849. /*
  850. @doc EXTERNAL PROPERTIES
  851. @prop PR_FAX_CP_NAME |
  852. This property is not currently used by Microsoft Fax.
  853. @comm Settable through UI: No
  854. */
  855. #define PR_FAX_CP_NAME PROP_TAG(PT_TSTRING, (EFAX_RECIPIENT_BASE + 0x1))
  856. #define PR_FAX_CP_NAME_W PROP_TAG(PT_UNICODE, (EFAX_RECIPIENT_BASE + 0x1))
  857. #define PR_FAX_CP_NAME_A PROP_TAG(PT_STRING8, (EFAX_RECIPIENT_BASE + 0x1))
  858. /*
  859. @doc EXTERNAL PROPERTIES
  860. @prop PR_RECIP_INDEX |
  861. This recipient property is internal to Microsoft Fax and should not be modified.
  862. @comm Settable through UI: No
  863. */
  864. #define PR_RECIP_INDEX PROP_TAG(PT_I2, (EFAX_RECIPIENT_BASE + 0x2))
  865. /*
  866. @doc EXTERNAL PROPERTIES
  867. @prop PR_HOP_INDEX |
  868. This recipient property is internal to Microsoft Fax and should not be modified.
  869. @comm Settable through UI: No
  870. */
  871. #define PR_HOP_INDEX PROP_TAG(PT_I2, (EFAX_RECIPIENT_BASE + 0x3))
  872. /*
  873. @doc EXTERNAL PROPERTIES
  874. @prop PR_RECIP_VOICENUM |
  875. This recipient property may be set on a received fax if the sender sent it.
  876. It contains the voice phone number associated with that recipient.
  877. @comm Settable through UI: No
  878. */
  879. #define PR_RECIP_VOICENUM PROP_TAG(PT_TSTRING, (EFAX_RECIPIENT_BASE + 0x4))
  880. /*
  881. @doc EXTERNAL PROPERTIES
  882. @prop PR_FAX_ENCRYPTION_KEY |
  883. ???
  884. @comm Settable through UI: Indirectly
  885. */
  886. #define PR_FAX_ENCRYPTION_KEY PROP_TAG(PT_BINARY, (EFAX_RECIPIENT_BASE + 0x5))
  887. /**********************************************************************************
  888. Property Values Section
  889. ***********************************************************************************/
  890. //
  891. // LOGON Properties
  892. //
  893. // Properties we store in the Profile.
  894. //
  895. // The following is used to access the properties in the logon array.
  896. // If you add a property to the profile, you should increment this number!
  897. #define MAX_LOGON_PROPERTIES 10
  898. // Other logon properties:
  899. // PR_SENDER_NAME - in mapitags.h
  900. // PR_SENDER_EMAIL_ADDRESS - in mapitags.h (this file)
  901. #define NUM_SENDER_PROPS 3 // How many sender ID properties?
  902. /*
  903. @doc EXTERNAL PROPERTIES
  904. @type NONE | PR_FAX_DELIVERY_FORMAT Values |
  905. Values for <t PR_FAX_DELIVERY_FORMAT>:
  906. @emem SEND_BEST | Use best available. (May be determined at call time if recipient
  907. capabilities are not yet cached.) Editable format will be preferred if the
  908. receiver is capable of receiving editable format. This is the default value.
  909. @emem SEND_EDITABLE | Send as email. If recipient is not capable, NDR.
  910. @emem SEND_PRINTED | Send as FAX image.
  911. */
  912. #define SEND_BEST 0
  913. #define SEND_EDITABLE 1
  914. #define SEND_PRINTED 2
  915. #define DEFAULT_SEND_AS SEND_BEST
  916. /*
  917. @doc EXTERNAL PROPERTIES
  918. @type NONE | PR_FAX_SEND_WHEN_TYPE Values |
  919. Values for <t PR_FAX_SEND_WHEN_TYPE>:
  920. @emem SEND_ASAP | Send as soon as possible. (This is the default value.)
  921. @emem SEND_CHEAP | Use the cheap times to determine when to send. These are
  922. specified in <t PR_FAX_CHEAP_BEGIN_HOUR>, <t PR_FAX_CHEAP_BEGIN_MINUTE>,
  923. <t PR_FAX_CHEAP_END_HOUR> and <t PR_FAX_CHEAP_END_MINUTE>.
  924. @emem SEND_AT_TIME | Send at the time specified in <t PR_FAX_NOT_EARLIER_HOUR> and
  925. <t PR_FAX_NOT_EARLIER_MINUTE>.
  926. */
  927. #define SEND_ASAP 0
  928. #define SEND_CHEAP 1
  929. #define SEND_AT_TIME 2
  930. #define DEFAULT_SEND_AT SEND_ASAP
  931. /*
  932. @doc EXTERNAL PROPERTIES
  933. @type NONE | PR_FAX_PAPER_SIZE Values |
  934. Values for <t PR_FAX_PAPER_SIZE>:
  935. @emem PAPER_US_LETTER | US Letter size.
  936. @emem PAPER_US_LEGAL | US Legal size.
  937. @emem PAPER_A4 | Metric A4 paper size.
  938. @emem PAPER_B4 | Metric B4 paper size.
  939. @emem PAPER_A4 | Metric A3 paper size.
  940. */
  941. #define PAPER_US_LETTER 0 // US Letter page size
  942. #define PAPER_US_LEGAL 1
  943. #define PAPER_A4 2
  944. #define PAPER_B4 3
  945. #define PAPER_A3 4
  946. // "real" default page size is in a resource string depending on U.S. vs metric
  947. #define DEFAULT_PAPER_SIZE PAPER_US_LETTER // Default page size
  948. /*
  949. @doc EXTERNAL PROPERTIES
  950. @type NONE | PR_FAX_PRINT_ORIENTATION Values |
  951. Values for <t PR_FAX_PRINT_ORIENTATION>:
  952. @emem PRINT_PORTRAIT | Portrait printing. (This is the default value.)
  953. @emem PAPER_LANDSCAPE | Landscape printing.
  954. */
  955. // Print Orientation
  956. // PR_FAX_PRINT_ORIENTATION
  957. #define PRINT_PORTRAIT 0 // Protrait printing
  958. #define PRINT_LANDSCAPE 1
  959. #define DEFAULT_PRINT_ORIENTATION PRINT_PORTRAIT
  960. /*
  961. @doc EXTERNAL PROPERTIES
  962. @type NONE | PR_FAX_IMAGE_QUALITY Values |
  963. Values for <t PR_FAX_IMAGE_QUALITY>:
  964. @emem IMAGE_QUALITY_BEST | Best available based upon cached capabilities.
  965. @emem IMAGE_QUALITY_STANDARD | Standard fax quality. (About 100 x 200 dpi)
  966. @emem IMAGE_QUALITY_FINE | Fine fax quality. (About 200 dpi)
  967. @emem IMAGE_QUALITY_300DPI | 300 DPI resolution.
  968. @emem IMAGE_QUALITY_400DPI | 400 DPI resolution.
  969. */
  970. #define IMAGE_QUALITY_BEST 0
  971. #define IMAGE_QUALITY_STANDARD 1
  972. #define IMAGE_QUALITY_FINE 2
  973. #define IMAGE_QUALITY_300DPI 3
  974. #define IMAGE_QUALITY_400DPI 4
  975. #define DEFAULT_IMAGE_QUALITY IMAGE_QUALITY_BEST
  976. // Modem specific property values are obsolete
  977. // PR_FAX_SPEAKER_VOLUME
  978. #define NUM_OF_SPEAKER_VOL_LEVELS 4 // Number of speaker volume levels
  979. #define DEFAULT_SPEAKER_VOLUME 2 // Default speaker volume level
  980. #define SPEAKER_ALWAYS_ON 2 // Speaker mode: always on
  981. #define SPEAKER_ON_UNTIL_CONNECT 1 // speaker on unitl connected
  982. #define SPEAKER_ALWAYS_OFF 0 // Speaker off
  983. #define DEFAULT_SPEAKER_MODE SPEAKER_ON_UNTIL_CONNECT // Default speaker mode
  984. // PR_FAX_ANSWER_MODE
  985. #define NUM_OF_RINGS 3
  986. #define ANSWER_NO 0
  987. #define ANSWER_MANUAL 1
  988. #define ANSWER_AUTO 2
  989. #define DEFAULT_ANSWER_MODE ANSWER_NO
  990. // Blind Dial
  991. #define DEFAULT_BLIND_DIAL 3
  992. // Comma Delay
  993. #define DEFAULT_COMMA_DELAY 2
  994. // Dial Tone Wait
  995. #define DEFAULT_DIAL_TONE_WAIT 30
  996. // Hangup Delay
  997. #define DEFAULT_HANGUP_DELAY 60
  998. /*
  999. @doc EXTERNAL PROPERTIES
  1000. @type NONE | PR_POLL_RETRIEVE_SENDME Values |
  1001. Values for <t PR_POLL_RETRIVE_SENDME>:
  1002. @emem SENDME_DEFAULT | Poll for the default document
  1003. @emem SENDME_DOCUMENT | Poll for the document named in
  1004. <t PR_POLL_RETRIEVE_TITLE>.
  1005. */
  1006. #define SENDME_DEFAULT 0
  1007. #define SENDME_DOCUMENT 1
  1008. // PR_POLLTYPE is obsolete
  1009. #define POLLTYPE_REQUEST 1
  1010. #define POLLTYPE_STORE 2
  1011. // Line ID (depends on the value in PR_FAX_ACTIVE_MODEM_TYPE)
  1012. // PR_FAX_ACTIVE_MODEM
  1013. #define NO_MODEM 0xffffffff // To show no modem is selected
  1014. // PR_FAX_TAPI_LOC_ID
  1015. #define NO_LOCATION 0xffffffff // No TAPI location