home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / Libraries / Internet Config 1.2 / Internet Config / APIs / ICCAPI.h < prev    next >
Encoding:
Text File  |  1995-09-25  |  27.1 KB  |  78 lines  |  [TEXT/CWIE]
  1. ries, ConstStr255Param filename, ICMapEntry *entry)
  2. FIVEWORDINLINE(0x2F3C, 12, 28, 0x7000, 0xA82A);
  3.   /* Requires IC 1.1.
  4.    * You must specify a configuration before calling this routine.
  5.    * You do not have to be inside an ICBegin/End pair to call this routine.
  6.    * Takes the name of an incoming file and returns the most appropriate
  7.    * mappings database entry, based on its extension.
  8.    * entries must be a handle to a valid IC mappings database preference.
  9.    * filename must not be the empty string.
  10.    * Returns icPrefNotFoundErr if no suitable entry is found.
  11.    */
  12.  
  13. pascal ICError ICCMapEntriesTypeCreator(internetConfigurationComponent inst, Handle entries, OSType fType, OSType fCreator, ConstStr255Param filename, ICMapEntry *entry)
  14. FIVEWORDINLINE(0x2F3C, 20, 29, 0x7000, 0xA82A);
  15.   /* Requires IC 1.1.
  16.    * You must specify a configuration before calling this routine.
  17.    * You do not have to be inside an ICBegin/End pair to call this routine.
  18.    * Takes the type and creator (and optionally the name) of an outgoing
  19.    * file and returns the most appropriate mappings database entry.
  20.    * entries must be a handle to a valid IC mappings database preference.
  21.    * The filename may be either the name of the outgoing file or
  22.    * the empty string.
  23.    * Returns icPrefNotFoundErr if no suitable entry found.
  24.    */
  25.  
  26. /* ----- Low Level Routines ----- */
  27.  
  28. pascal ICError ICCCountMapEntries(internetConfigurationComponent inst, Handle entries, long *count)
  29. FIVEWORDINLINE(0x2F3C, 8, 18, 0x7000, 0xA82A);
  30.   /* Requires IC 1.1.
  31.    * You must specify a configuration before calling this routine.
  32.    * You do not have to be inside an ICBegin/End pair to call this routine.
  33.    * Counts the number of entries in the mappings database.
  34.    * entries must be a handle to a valid IC mappings database preference.
  35.    * count is set to the number of entries.
  36.    */
  37.  
  38. pascal ICError ICCGetIndMapEntry(internetConfigurationComponent inst, Handle entries, long ndx, long *pos, ICMapEntry *entry)
  39. FIVEWORDINLINE(0x2F3C, 16, 19, 0x7000, 0xA82A);
  40.   /* Requires IC 1.1.
  41.    * You must specify a configuration before calling this routine.
  42.    * You do not have to be inside an ICBegin/End pair to call this routine.
  43.    * Gets the ndx'th entry in the mappings database.
  44.    * entries must be a handle to a valid IC mappings database preference.
  45.    * ndx must be in the range from 1 to the number of entries in the database.
  46.    * The value of pos is ignored on input. pos is set to the position of
  47.    * the ndx'th entry in the database and is suitable for passing back
  48.    * into ICSetMapEntry.
  49.    * Does not return any user data associated with the entry.
  50.    */
  51.  
  52. pascal ICError ICCGetMapEntry(internetConfigurationComponent inst, Handle entries, long pos, ICMapEntry *entry)
  53. FIVEWORDINLINE(0x2F3C, 12, 20, 0x7000, 0xA82A);
  54.   /* Requires IC 1.1.
  55.    * You must specify a configuration before calling this routine.
  56.    * You do not have to be inside an ICBegin/End pair to call this routine.
  57.    * Returns the entry located at position pos in the mappings database.
  58.    * entries must be a handle to a valid IC mappings database preference.
  59.    * pos should be 0 to get the first entry. To get the subsequent entries, add
  60.    * entry.total_size to pos and iterate.
  61.    * Does not return any user data associated with the entry.
  62.    */
  63.  
  64. pascal ICError ICCSetMapEntry(internetConfigurationComponent inst, Handle entries, long pos, ICMapEntry *entry)
  65. FIVEWORDINLINE(0x2F3C, 12, 21, 0x7000, 0xA82A);
  66.   /* Requires IC 1.1.
  67.    * You must specify a configuration before calling this routine.
  68.    * You do not have to be inside an ICBegin/End pair to call this routine.
  69.    * Sets the entry located at position pos in the mappings database.
  70.    * entries must be a handle to a valid IC mappings database preference.
  71.    * pos should be either a value returned from ICGetIndMapEntry or a value
  72.    * calculated using ICGetMapEntry.
  73.    * entry is a var parameter purely for stack space reasons. It is not
  74.    * modified in any way.
  75.    * Any user data associated with the entry is unmodified.
  76.    */
  77.  
  78. pascal ICError ICCDeleteMapEntry(inte