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.

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