
This document was written to describe how resources (dialogs, bitmaps, strings)
are managed properly in the WAN Links configuration DLLs.  Because most of
these DLLs are MFC extension DLLs, each containing their own resources, it
is possible that the wrong resource may get loaded at run time (see "PRB: MFC
Loads Wrong Resource in Extension DLL" Article ID: Q150121).  There are several
ways to solve this problem (see "TN035: Using Multiple Resource Files and
Header Files with Visual C++"). Compounded by the fact that help map IDs are
derived from resouce IDs, I have chosen the MS recommened method of ensuring
that resources have unique IDs by allocating them from pools of non-overlapping
IDs per project.

This is accomplished by modifying the resource.h file by hand after creating
a new project.  Resource.h contains a section used by ApStudio for calculating
resource IDs (see C code below).  This section must be changed so that IDs
are automagically assigned to new resources in the proper range.  This entire
process is described in TN035.

Below I have documented the ApStudio macros used, their valid value ranges,
and have created 25 pools of values.  When creating a WAN Links config DLL,
you MUST modify this document to reflect which pool of IDs you are using.

Special note for strings.  The resource editor likes to start numbering
strings in a string table at 1.  If your DLL uses strings, you must first
add a string into the table.  Then modify the new macro in resource.h to be
the first value in you pool.  From that point on, the resource editor will
add 1 to the larges IDS_ value it finds to create new string IDs.

Special note for custom user added resource IDs.  Resource IDs starting with
the prefix IDH_ will be considered to be custom help IDs, and compiled into
the help map file.  Please reserve this prefix for ONLY custom help IDs.


// Next default values for new objects
// 
                                 // min     max     1st    inc
#ifdef APSTUDIO_INVOKED
#ifndef APSTUDIO_READONLY_SYMBOLS
#define _APS_NEXT_RESOURCE_VALUE      1 - 28671 -   101 -  250          // dialogs, bitmaps, icons, etc.
#define _APS_NEXT_COMMAND_VALUE   32768 - 57343 - 33001 -  500          // menu items
#define _APS_NEXT_CONTROL_VALUE       8 - 57343 -  6501 - 2000          // buttons, comboboxes, etc.
#define _APS_NEXT_SYMED_VALUE         ? -     ? -  6501 - 1000          // ?
#endif
#endif

STRINGS                               1 -     ? -  1001 - 1000

PROJECT        RESOURCE    COMMAND     CONTROL     SYMED    STRING
-------------------------------------------------------------------
DigiAsyn            101      33001        6501      6501      1001
DigiDBP             351      33501        8501      7501      2001
DigiFWrk            601      34001       10501      8501      3001
DigiHLC             851      34501       12501      9501      4001
DigiInf            1101      35001       14501     10501      5001
DigiISDN           1351      35501       16501     11501      6001
DigiSNA            1601      36001       18501     12501      7001
DigiClyd           1851      36501       20501     13501      8001
LineWAN            2101      37001       22501     14501      9001
DigiFrX            2351      37501       24501     15501     10001
DigiPPP            2601      38001       26501     16501     11001
LineCSU            2851      38501       28501     17501     12001
                   3101      39001       30501     18501     13001
                   3351      39501       32501     19501     14001
                   3601      40001       34501     20501     15001
                   3851      40501       36501     21501     16001
                   4101      41001       38501     22501     17001
                   4351      41501       40501     23501     18001
                   4601      42001       42501     24501     19001
                   4851      42501       44501     25501     20001
                   5101      43001       46501     26501     21001
                   5351      43501       48501     27501     22001
                   5601      44001       50501     28501     23001
                   5851      44501       52501     29501     24001
                   6101      45001       54501     30501     25001
