key = value

   #define   strsize 32
   CString   SectionName("intl";)
   CString   KeyName("sShortDate");
   FAR char  sShortDate[ strsize ];
   CString   Default("Not Found");

   result =
      ::GetProfileString( SectionName, KeyName, Default, sShortDate, strsize);

Each Windows installation is unique and does not require every key in the intl section to have a corresponding value. So it is important to provide an appropriate default value when calling either function. To see what keys are defined you can set the KeyName parameter to NULL and the function then returns all the keynames found in the indicated section, in ReturnString. Each key name returned is null-terminated and the final key name is terminated with two nulls. If the supplied buffer is too small then Windows returns as many key names as will fit — the last one returned is truncated and terminated with two null characters.

The GetProfileInt function is a little less cumbersome to use since it only deals with an integer value rather than strings. The prototype for GetProfileInt is:

WORD GetProfileInt( LPSTR SectionName, LPSTR KeyName,
                 int DefaultValue );

   [SectionName]
   KeyName = value

   CString   SectionName("intl");
   CString   KeyName("iTime");
   int       Default = -1;
   WORD      result;
   result = ::GetProfileInt( SectionName, KeyName,
                         Default);
   switch( result )
   {
      case 0 :
          AfxMessageBox("Use a 12 hour clock "); break;
      case 1:
          AfxMessageBox("Use a 24 hour clock "); break;

      case Default:
      default:
      AfxMessageBox(" iTime key not found! ");
      // set a default value for clock format, break;
   } // end switch

   char        Value[16];
   CString     Section;
   CString     Key;
   BOOL        retv;
   int         iTimeValue = 1;  // use the 24 hour clock

   sprintf(Value,"%d", iTimeValue);
   retv = ::WriteProfileString( Section, Key, Value);
   if ( retv )
   {
      ::SendMessage(  HWND_BROADCAST,   // -1, send to all
                                  // windows
                    WM_WININICHANGE, // message
                    0L,              // not required
                    Section);        // section updated
}