在 WinCe 平台读写 ini 文件

      在上篇文章开发 windows mobile 上的今日插件时，我发现 wince 平台上不支持例如 GetPrivateProfileString 等相关 API 函数。在网络上我并没有找到令我满意的相应代码，因此我手工自己写了相应的方法。命名规则是，在 PC API 函数的名称前面加上 “Ce” 前缀，这是为了在 PC 平台上调试和使用时，不和系统的 API 函数发生冲突。值得注意的是，在写 CeWritePrivateProfileString 方法时，如果改写后的 ini 文件应该比改写前的文件小，文件尾部将会是一些不确定内容（来自于原来文件）。在 PC 上我们可以通过 <io.h> 中的 _chsize 函数重新设置文件大小，但是很遗憾的是，这些底层的文件操作函数在 wince 平台上依然不被支持，但是幸运的是，可以使用 coredll.dll 中提供的 SetEndOfFile 函数去完成相同功能（感谢88上的 kghost 的提示）。
　　另外我额外提供了一个函数：CeGetPrivateProfileKeyNames，用于读取某个 section 的所有 key 名称。
　　当然，如果是在 PC 平台，我们就没有必要使用这里我所提供的代码，因为有系统 API 可以调用。
　　需要注意的是，我提供的代码和 PC 端 API 相比，基本功能，参数意义完全相同，但具有以下一些额外要求：
　　（1）大小写敏感。（当然也可以通过修改代码，令其大小写不敏感）
　　（2）每一行，section， key， value， “=” 的前后不允许有空格。
　　（3）注释行用英文分号“;"起始。允许存在空行。
　　（4）每一行的字符数不能超过 260 字符（取决于代码中的宏定义）。
　　（5）函数代码同时适用 unicode 和多字节字符串 的环境。
　　（6）由于采用标准文件操作函数，因此 CeGetPrivateProfileSectionNames 函数并不保证原子性。（这一点和 PC API 不同）

　　下面是相关函数代码：
　　(a) IniFile.h

/***************************************
 * IniFile.h
 * 说明：在WinCe平台读写 INI 文件
 * by hoodlum1980
 * 2009.08.03 
 ***************************************/
#ifndef __INIFILE_H_BY_HOODLUM1980
#define __INIFILE_H_BY_HOODLUM1980

//是否在WINCE平台上
#ifndef WINCE
#define WINCE
#endif

#include "StdAfx.h"
#ifndef WINCE
    #include <io.h>        //for _sopen
    #include <fcntl.h>    //for _O_RDWT
    #include <share.h>    // for _SH_DENYRW
#endif

#ifdef  UNICODE   // r_winnt
    #define t_sopen            _wsopen        //注意WinCe上不支持！
    #define t_fopen         _wfopen
    #define t_fgets            fgetws
    #define t_fprintf        fwprintf    //文件格式化写入
    #define t_sprintf        swprintf    //格式化文本
    #define t_strcpy        wcscpy
    #define t_strncpy        wcsncpy        //拷贝指定个数的字符
    #define t_strcat        wcscat        //append a string
    #define t_strtol        wcstol
    #define t_strlen        wcslen
    #define t_strcmp        wcscmp
    #define t_stricmp        _wcsicmp    //忽略大小写的字符串比较
    #define t_strncmp        wcsncmp        //比较n个字符
    #define t_strchr        wcschr        //find a character in a string
    #define t_strrchr        wcsrchr        //从结尾向前查找字符

#else  //ASCII CODE

    #define t_sopen            _sopen        //注意WinCe上不支持！
    #define t_fopen         fopen
    #define t_fgets            fgets        //读取一行文本
    #define t_fprintf        fprintf        //文件格式化写入
    #define t_sprintf        sprintf        //格式化文本
    #define t_strcpy        strcpy
    #define t_strncpy        strncpy        //拷贝指定个数的字符
    #define t_strcat        strcat        //append a string
    #define t_strtol        strtol        //把字符串转换成long（int32）
    #define t_strlen        strlen
    #define t_strcmp        strcmp        //比较字符串
    #define t_stricmp        _stricmp    //忽略大小写的字符串比较
    #define t_strncmp        strncmp        //比较n个字符
    #define t_strchr        strchr        //查找字符
    #define t_strrchr        strrchr        //从结尾向前查找字符

#endif

//CeWritePrivateProfileString 方法用到的辅助标记
#define MODE_DELETE_SECTION        11
#define MODE_OVERWRITE_SECTION    12
#define MODE_APPEND_SECTION        13
#define MODE_DELETE_KEY            21
#define MODE_OVERWRITE_KEY        22
#define MODE_APPEND_KEY            23

#define LINESIZE                260    //行缓冲区大小

DWORD CeGetPrivateProfileString(
    LPCTSTR lpAppName,                //section name: [lpAppName]
    LPCTSTR lpKeyName,                //lpKeyName=lpReturnedString
    LPCTSTR lpDefault,                //未找到时的默认值
    LPTSTR lpReturnedString,        //[out] 查找到的结果
    DWORD nSize,                    //[in]lpReturnedString的字符数,注意单位不是字节！
    LPCTSTR lpFileName
    );

UINT CeGetPrivateProfileInt(
    LPCTSTR lpAppName,
    LPCTSTR lpKeyName,
    int nDefault,
    LPCTSTR lpFileName
    );

DWORD CeGetPrivateProfileSection(
    LPCTSTR lpAppName,
    LPTSTR lpReturnedString,
    DWORD nSize,
    LPCTSTR lpFileName
    );

DWORD CeGetPrivateProfileSectionNames(
    LPTSTR lpszReturnBuffer,
    DWORD nSize,
    LPCTSTR lpFileName
    );

//在PC平台上可以调用_chsize函数调整文件大小，但是在WINCE平台上
//由于不支持，所以必须注意当文件尺寸应该缩小时，文件尾部内容不确定！！！！
BOOL CeWritePrivateProfileString(
    LPCTSTR lpAppName,
    LPCTSTR lpKeyName,    //要修改的KEY，如果为NULL，会删除整个Section
    LPCTSTR lpString,    //要写入的值，如果为NULL，则会删除这个KEY
    LPCTSTR lpFileName
    );

//重写某个Section，注意和 PC API 的区别是，这里不保证原子性操作
BOOL CeWritePrivateProfileSection(
    LPCTSTR lpAppName,    //section name
    LPCTSTR lpString,    //key1=val1 \0 key2=val2 \0\0
    LPCTSTR lpFileName
    );

//==============================================
//        以下是我增加的函数（在API中没有）
//==============================================
DWORD CeGetPrivateProfileKeyNames(
    LPCTSTR lpAppName,
    LPTSTR lpReturnedString,
    DWORD nSize,                //缓冲区的字符数
    LPCTSTR lpFileName
    );

#endif

　　(b) IniFile.cpp

//适用于 char* 和 UNICODE，
//所有字符串必须使用 TEXT("aa") 或者 _T("aa") 的格式（自动适应 char* 或 UNICODE）
//所有相关函数加t_前缀
//IniFile: 读取INI FILE的简单解析!所谓简单，也就是解析代码简单，但对文件格式要求更高
//[1]任何字符串前后不要有空格（使解析代码可以不考虑前后的trim）
//            例如允许"Key1=Val", 而不允许" Key1 = Val "
//[2]允许有注释，第一个字符必须是英文分号';'
//
#include "StdAfx.h"
#include "IniFile.h"

//从appname（section）中读取string类型key
DWORD CeGetPrivateProfileString(
    LPCTSTR lpAppName,                //section name: [lpAppName]
    LPCTSTR lpKeyName,                //lpKeyName=lpReturnedString
    LPCTSTR lpDefault,                //未找到时的默认值
    LPTSTR lpReturnedString,    //[out] 查找到的结果
    DWORD nSize,                            //[in]lpReturnedString的字符数,注意单位不是字节！
    LPCTSTR lpFileName
    )
{
    DWORD ret = 0;
    FILE *stream;
    bool bFindVal = false;
    bool bFindSection = false;
    TCHAR line[ LINESIZE ];
    size_t sectionLength, keyLength, lineLength;
    
    stream = t_fopen(lpFileName, _T("r"));
    if(stream == NULL)
    {
        //设置默认值
        t_strcpy(lpReturnedString, lpDefault);
        ret = t_strlen(lpReturnedString); 
        return ret;
    }
    
    sectionLength = t_strlen(lpAppName);
    
    while(t_fgets(line, LINESIZE, stream) != NULL)
    {
        //忽略注释行和空行
        if(line[0] == 0 || line[0] == ';') continue;
        lineLength = t_strlen(line);
        //注意：把LF（0xa）字符替换成0，这在UNICODE环境下可能出现结尾是LF）
        if(line[ lineLength - 1 ] == 0x0a)
        {
            line[ lineLength - 1 ] = 0;
            lineLength--;
            //注意此时可能会成为空字符串
            if(lineLength == 0) continue;
        }
        
        //尝试寻找到 section
        if(!bFindSection)
        {
            if(line[0] != '[') continue; //本行是否是 [section]
            //这里是我们想要的Section吗？
            //检查这一行的宽度是否正好是section长度加2， [lpAppName]
            if(line[sectionLength + 1] != ']') continue;
            if(t_strncmp(line+1, lpAppName, sectionLength) != 0) continue;
            //Now Section will appear on next line 
            //读取section前求出 Key 的长度
            keyLength = t_strlen(lpKeyName);
            bFindSection = true;            
            continue;
        }
        
        //查找Key, Section End?
        if(line[0]=='[') break; //遇到了下一个
            
        if(lineLength < keyLength+1 || line[keyLength] != '=') continue; //"KeyName="
        if(t_strncmp(line, lpKeyName, keyLength)!=0) continue;
        //Now We Get the Key! 
        t_strcpy(lpReturnedString, line + keyLength + 1);
        //Now It's done.
        bFindVal = true;
        break;
    }
    
    fclose(stream);
    if(!bFindVal)
    {
        //设置默认值
        t_strcpy(lpReturnedString, lpDefault); 
    }
    ret = t_strlen(lpReturnedString); 
    return ret;
}


//读取一个int值
UINT CeGetPrivateProfileInt(
    LPCTSTR lpAppName,
    LPCTSTR lpKeyName,
    int nDefault,
    LPCTSTR lpFileName
    )
{
    long ret = nDefault; //返回值
    FILE *stream;
    bool bFindVal = false;
    bool bFindSection = false;
    TCHAR line[ LINESIZE ];
    size_t sectionLength, keyLength, lineLength;
    
    stream = t_fopen(lpFileName, _T("r"));
    if(stream == NULL)
    {
        //设置默认值
        return nDefault;
    }
    
    sectionLength = t_strlen(lpAppName);
    
    while(t_fgets(line, LINESIZE, stream) != NULL)
    {
        //忽略注释行和空行
        if(line[0] == 0 || line[0] == ';') continue;
        lineLength = t_strlen(line);
        //注意：把LF（0xa）字符替换成0，这在UNICODE环境下可能出现结尾是LF）
        if(line[ lineLength - 1 ] == 0x0a)
        {
            line[ lineLength - 1 ] = 0;
            lineLength--;
            //注意此时可能会成为空字符串
            if(lineLength == 0) continue;
        }
        
        //尝试寻找到 section
        if(!bFindSection)
        {
            if(line[0] != '[') continue; //本行是否是 [section]
            //这里是我们想要的Section吗？
            //检查这一行的宽度是否正好是section长度加2， [lpAppName]
            if(line[sectionLength + 1] != ']') continue;
            if(t_strncmp(line+1, lpAppName, sectionLength) != 0) continue;
            //Now Section will appear on next line 
            //读取section前求出 Key 的长度
            keyLength = t_strlen(lpKeyName);
            bFindSection = true;            
            continue;
        }
        
        //查找Key, Section End?
        if(line[0]=='[') break; //遇到了下一个
            
        if(lineLength < keyLength+1 || line[keyLength] != '=') continue; //"KeyName="
        if(t_strncmp(line, lpKeyName, keyLength)!=0) continue;
        //Now We Get the Key! 
        TCHAR *pStopChar = NULL;
        ret = t_strtol(line + keyLength + 1, &pStopChar, 10); //默认为10进制
        //Now It's done.
        bFindVal = true;
        break;
    }
    
    fclose(stream);
    return ret;
}


//获取某个Section下面的所有“key=value”形式的字符串集合，以0字符分割
//结尾使用两个0字符
//缓冲区写入："key1=value1 \0 key2=value2 \0 \0 "
//返回值表示写入缓冲区的字符数, 不包括结尾的0字符。
//如果缓冲区不够容纳所有的键值对，则返回值 = (nSize-2)
DWORD CeGetPrivateProfileSection(
    LPCTSTR lpAppName,
    LPTSTR lpReturnedString,
    DWORD nSize,                //缓冲区的字符数
    LPCTSTR lpFileName
    )
{
    DWORD ret = 0; //返回值，拷贝的字符数量
    DWORD remainSize = nSize - 2; //缓冲区当前所能能够接纳的字符数量
    DWORD copySize;                //本次循环中需要拷贝的字符数量
    FILE *stream;
    bool bFindSection = false; //是否已经找到Section
    TCHAR line[ LINESIZE ];   //行缓冲区
    LPTSTR pItem; //指向当前键值对的写入地址
    size_t sectionLength, lineLength;
    

    pItem = lpReturnedString; //指向缓冲区起始地址

    stream = t_fopen(lpFileName, _T("r"));
    if(stream == NULL)
    {
        return ret;
    }
    
    sectionLength = t_strlen(lpAppName);
    
    while(t_fgets(line, LINESIZE, stream) != NULL)
    {
        //缓冲区是否还有剩余空间？
        if(remainSize <= 0) break;

        //忽略注释行和空行
        if(line[0] == 0 || line[0] == ';') continue;
        lineLength = t_strlen(line);
        //注意：把LF（0xa）字符替换成0，这在UNICODE环境下可能出现结尾是LF）
        if(line[ lineLength - 1 ] == 0x0a)
        {
            line[ lineLength - 1 ] = 0;
            lineLength--;
            //注意此时可能会成为空字符串
            if(lineLength == 0) continue;
        }
        
        //尝试寻找到 section
        if(!bFindSection)
        {
            if(line[0] != '[') continue; //本行是否是 [section]
            //这里是我们想要的Section吗？
            //检查这一行的宽度是否正好是section长度加2， [lpAppName]
            if(line[sectionLength + 1] != ']') continue;
            if(t_strncmp(line+1, lpAppName, sectionLength) != 0) continue;
            //Now Section will appear on next line 
            bFindSection = true;            
            continue;
        }
        
        //查找Key, Section End?
        if(line[0]=='[') break; //遇到了下一个

        //copy the line to buffer, 注意ncpy不会复制结尾的0字符
        copySize = min( remainSize, lineLength );
        t_strncpy(pItem, line, copySize);
        //追加一个0字符
        pItem[copySize] = 0;

        //缩小缓冲区剩余字符数量remainSize，和当前写入位置pItem
        ret += (copySize + 1); //加1是为了统计结尾的0字符
        remainSize -= (copySize + 1);
        pItem += (copySize + 1);
    }
    
    fclose(stream);

    if(bFindSection)
    {
        //再次对缓冲区追加一个0 字符
        *pItem = 0;
    }
    return ret;
}


//获取一个ini文件中所有section的name，拷贝到缓冲区
//注意和系统API的区别是，系统API的读取是原子性的，即读取时不允许修改ini文件的内容
//而我们的函数未必保证这一点
DWORD CeGetPrivateProfileSectionNames(
    LPTSTR lpszReturnBuffer,
    DWORD nSize,
    LPCTSTR lpFileName
    )
{
    DWORD ret = 0;                    //返回值，拷贝的字符数量
    DWORD remainSize = nSize - 2;    //缓冲区当前所能能够接纳的字符数量
    DWORD copySize;                    //本次循环中需要拷贝的字符数量
    TCHAR line[ LINESIZE ];            //行缓冲区
    TCHAR *pSectionEndChar;            //']'字符指针
    LPTSTR pItem;                    //指向当前键值对的写入地址
    FILE *stream;                    //流指针
    size_t lineLength;                //行字符长度
    
    pItem = lpszReturnBuffer; //指向缓冲区起始地址

    stream = t_fopen(lpFileName, _T("r"));
    if(stream == NULL)
    {
        return ret;
    }
    
    while(t_fgets(line, LINESIZE, stream) != NULL)
    {
        //缓冲区是否还有剩余空间？
        if(remainSize <= 0) break;

        //忽略注释行和空行
        if(line[0] == 0 || line[0] == ';') continue;
        lineLength = t_strlen(line);
        //注意：把LF（0xa）字符替换成0，这在 UNICODE 环境下可能出现结尾是LF）
        if(line[ lineLength - 1 ] == 0x0a)
        {
            line[ lineLength - 1 ] = 0;
            lineLength--;
            //注意此时可能会成为空字符串
            if(lineLength == 0) continue;
        }

        if(line[0] != '[') continue; //本行是否是 [section]
        //找到了一个Section，开始拷贝
        //copy the section name to buffer, 注意ncpy不会复制结尾的0字符

        //LINE: "[sectionName]"
        //       |           |
        //     line      pSectionEndChar

        //找出‘=’字符的位置
        pSectionEndChar = t_strchr(line, ']');
        if(pSectionEndChar != NULL)
        {
            //找到了‘=’字符，（pEqualChar - line）是key的长度
            copySize = min( remainSize,  pSectionEndChar - line - 1 );
        }
        else
        {
            //本行中不存在‘]’字符，对于合法文件来说不会出现此种情况
            copySize = min( remainSize, lineLength - 1 );
        }

        t_strncpy(pItem, line+1, copySize);

        //追加一个0字符
        pItem[copySize] = 0;

        //缩小缓冲区剩余字符数量remainSize，和当前写入位置pItem
        ret += (copySize + 1); //加1是为了统计结尾的0字符
        remainSize -= (copySize + 1);
        pItem += (copySize + 1);
    }

    fclose(stream);
    //再次对缓冲区追加一个0 字符
    *pItem = 0;
    return ret;
}

//
BOOL CeWritePrivateProfileString(
    LPCTSTR lpAppName,
    LPCTSTR lpKeyName,    //要修改的KEY，如果为NULL，会删除整个Section
    LPCTSTR lpString,    //要写入的值，如果为NULL，则会删除这个KEY
    LPCTSTR lpFileName
    )
{
    FILE *stream;
    void *pVoid = NULL; //文件的后半部分
    bool bFindKey = false;
    bool bFindSection = false;
    TCHAR line[ LINESIZE ];
    size_t sectionLength, keyLength, lineLength, nBytesRead = 0;
    LONG nInsertPos = -1, nCopyPos = -1, nFileEndPos, nPos; //文件指针位置
    LONG nSectionBegin = -1, nKeyBegin = -1, nNextKey = -1, nNextSection = -1;
    BYTE mode = 0;
    
    //如果 sectionName 为NULL，返回成功
    if(lpAppName == NULL)
        return true;

    //r+: Opens for both reading and writing. (The file must exist.)
    stream = t_fopen(lpFileName, _T("r+"));
    if(stream == NULL)
    {
        return false;
    }

    //先取一次mode的默认值
    if(lpKeyName == NULL)
        mode = MODE_DELETE_SECTION;
    else if(lpString == NULL)
        mode = MODE_DELETE_KEY;
    else
        mode = MODE_OVERWRITE_KEY;

    sectionLength = t_strlen(lpAppName);
    
    //每次读行前，保存文件指针位置
    while(nPos = ftell(stream), t_fgets(line, LINESIZE, stream) != NULL)
    {
        //忽略注释行和空行
        if(line[0] == 0 || line[0] == ';') continue;
        lineLength = t_strlen(line);
        //注意：把LF（0xa）字符替换成0，这在UNICODE环境下可能出现结尾是LF）
        if(line[ lineLength - 1 ] == 0x0a)
        {
            line[ lineLength - 1 ] = 0;
            lineLength--;
            //注意此时可能会成为空字符串
            if(lineLength == 0) continue;
        }
        
        //尝试寻找到 section
        if(!bFindSection)
        {
            if(line[0] != '[') continue; //本行是否是 [section]
            //这里是我们想要的Section吗？
            //检查这一行的宽度是否正好是section长度加2， [lpAppName]
            if(line[sectionLength + 1] != ']') continue;
            if(t_strncmp(line+1, lpAppName, sectionLength) != 0) continue;
            //Now Section will appear on next line 
            //读取section前求出 Key 的长度
            if(lpKeyName != NULL)
                keyLength = t_strlen(lpKeyName);
            
            nSectionBegin = nPos;

            bFindSection = true;        
            continue;
        }
        
        //Section找到了，
        //Section End ?
        if(line[0]=='[') 
        {
            nNextSection = nPos;
            break; //遇到了下一个
        }

        //是否需要查找KEY？
        if(lpKeyName != NULL)
        {            
            if(lineLength < keyLength+1 || line[keyLength] != '=') continue; //"KeyName="
            if(t_strncmp(line, lpKeyName, keyLength) != 0) continue;
            //Now We Get the Key! 
            nKeyBegin = nPos;
            nNextKey = ftell(stream); //要拷贝的起始位置
            //Now It's done.
            bFindKey = true;
            break;
        }
    }

    //如果已经到达文件尾部，则追加换行
    if(feof(stream))
        t_fprintf(stream, _T("\r\n"));

    if(nNextSection < 0) nNextSection = ftell(stream);
    if(nNextKey < 0) nNextKey = ftell(stream);

    //遍历后再次更新mode值
    if(mode == MODE_DELETE_SECTION)
    {
        if(!bFindSection)
        {
            fclose(stream);
            return true;
        }
        else
        {
            nInsertPos = nSectionBegin;
            nCopyPos = nNextSection;
        }
    }
    if(mode == MODE_DELETE_KEY)
    {
        if(!bFindKey)
        {
            fclose(stream);
            return true;
        }
        else
        {
            nInsertPos = nKeyBegin;
            nCopyPos = nNextKey;
        }
    }
    if(mode == MODE_OVERWRITE_KEY)
    {
        if(!bFindSection)
        {
            mode = MODE_APPEND_SECTION;
        }
        else
        {
            if(bFindKey)
            {
                nInsertPos = nKeyBegin;
                nCopyPos = nNextKey;
            }
            else
            {
                mode = MODE_APPEND_KEY;
                nInsertPos = nNextSection;
                nCopyPos = nNextSection;
            }
        }
    }

    //追加一个新的Section
    if(mode == MODE_APPEND_SECTION)
    {
        t_fprintf(stream, _T("\r\n[%s]\r\n%s=%s\r\n"), lpAppName, lpKeyName, lpString);
        fclose(stream);
        return true;
    }

    //先把文件的后半部分拷贝到内存
    fseek(stream, 0, SEEK_END);
    nFileEndPos = ftell(stream);
    if(nCopyPos >= 0 && nCopyPos < nFileEndPos)
    {
        //分配内存作为缓冲区
        pVoid = malloc(nFileEndPos - nCopyPos + 1);

        if(pVoid == NULL)
        {
            fclose(stream);
            return false; //堆内存不足
        }
        fseek(stream, nCopyPos, SEEK_SET);
        nBytesRead = fread(pVoid, 1, nFileEndPos - nCopyPos + 1, stream);
    }

    //写入新的value值
    fseek(stream, nInsertPos, SEEK_SET);
    if(lpKeyName != NULL && lpString != NULL)
        t_fprintf(stream, _T("%s=%s\r\n"), lpKeyName, lpString);

    //现在把文件的后半部分写回文件中
    if(pVoid != NULL && nBytesRead > 0)
    {
        fwrite(pVoid, 1, nBytesRead, stream);
        free(pVoid);
    }

    //此时结尾可能还有一些内容，属于原来的ini文件
    //我们把它写成注释
    nPos = ftell(stream);
    fclose(stream);

    //如果文件变小了，那么我们需要更改文件大小
    if(nPos < nFileEndPos)
    {
#ifdef WINCE    //WINCE平台
        HANDLE handle = CreateFile(
            lpFileName, //LPCTSTR lpFileName
            GENERIC_WRITE, //DOWRD dwDesiredAccess,
            0, //DWORD dwShareMode, 非共享模式
            NULL, //LPSECURITY_ATTRIBUTES lpSecurityAttributes, ignored
            OPEN_EXISTING, //DWORD dwCreationDispostion, 
            FILE_ATTRIBUTE_NORMAL, //DWORD dwFlagsAndAttributes, 
            NULL//HANDLE hTemplateFile, ignored
            ); 

        if(handle != NULL)
        {
            //移动文件指针
            SetFilePointer(handle, nPos, NULL, FILE_BEGIN);
            //设置EOF
            SetEndOfFile(handle);
            //关闭
            CloseHandle(handle);
        }

#else            //PC 平台
        int handle = t_sopen(lpFileName, _O_RDWR, _SH_DENYRW);
        if(handle > 0)
        {
            //修改文件大小
            _chsize(handle, nPos);
            //关闭文件
            _close(handle);
        }
#endif //
    }
    return TRUE;
}


//重写某个Section，注意和 PC API 的区别是，这里不保证原子性操作
BOOL CeWritePrivateProfileSection(
    LPCTSTR lpAppName,    //section name
    LPCTSTR lpString,    //key1=val1 \0 key2=val2 \0\0
    LPCTSTR lpFileName
    )
{
    FILE *stream;
    void *pVoid = NULL; //文件的后半部分
    bool bFindSection = false;
    TCHAR line[ LINESIZE ]; //行缓冲区
    LPCTSTR pItem = lpString;
    size_t sectionLength, lineLength, nBytesRead = 0;
    LONG nFileEndPos, nPos; //文件指针位置
    LONG nSectionBegin = -1, nNextSection = -1;
    
    //如果 sectionName 为NULL，返回失败
    if(lpAppName == NULL || lpString == NULL)
        return false;

    //r+: Opens for both reading and writing. (The file must exist.)
    stream = t_fopen(lpFileName, _T("r+"));
    if(stream == NULL)
    {
        return false;
    }

    sectionLength = t_strlen(lpAppName);
    
    //每次读行前，保存文件指针位置
    while(nPos = ftell(stream), t_fgets(line, LINESIZE, stream) != NULL)
    {
        //忽略注释行和空行
        if(line[0] == 0 || line[0] == ';') continue;
        lineLength = t_strlen(line);
        //注意：把LF（0xa）字符替换成0，这在UNICODE环境下可能出现结尾是LF）
        if(line[ lineLength - 1 ] == 0x0a)
        {
            line[ lineLength - 1 ] = 0;
            lineLength--;
            //注意此时可能会成为空字符串
            if(lineLength == 0) continue;
        }
        
        //尝试寻找到 section
        if(!bFindSection)
        {
            if(line[0] != '[') continue; //本行是否是 [section]
            //这里是我们想要的Section吗？
            //检查这一行的宽度是否正好是section长度加2， [lpAppName]
            if(line[sectionLength + 1] != ']') continue;
            if(t_strncmp(line+1, lpAppName, sectionLength) != 0) continue;
            //Now Section will appear on next line 
            nSectionBegin = nPos;
            bFindSection = true;        
            continue;
        }
        
        //Section找到了，
        //Section End ?
        if(line[0]=='[') 
        {
            nNextSection = nPos;
            break; //遇到了下一个
        }
    }

    //如果已经到达文件尾部，则追加换行
    if(nNextSection < 0) nNextSection = ftell(stream);

    //追加一个新的Section
    if(!bFindSection)
    {
        nSectionBegin = ftell(stream);
    }

    //覆写Section
    //先把文件的后半部分拷贝到内存
    fseek(stream, 0, SEEK_END);
    nFileEndPos = ftell(stream);
    if(nNextSection >= 0 && nNextSection < nFileEndPos)
    {
        //分配内存作为缓冲区
        pVoid = malloc(nFileEndPos - nNextSection + 1);

        if(pVoid == NULL)
        {
            fclose(stream);
            return false; //堆内存不足
        }
        fseek(stream, nNextSection, SEEK_SET);
        nBytesRead = fread(pVoid, 1, nFileEndPos - nNextSection + 1, stream);
    }
    
    //逐行写入key = val
    fseek(stream, nSectionBegin, SEEK_SET);
    //再次写入[section]，如果不存在就会追加
    t_fprintf(stream, _T("[%s]\r\n"), lpAppName);
    while(*pItem)
    {
        t_fprintf(stream, _T("%s\r\n"), pItem);
        pItem += t_strlen(pItem) + 1; //移动到下一行
    }

    //现在把文件的后半部分写回文件中
    if(pVoid != NULL)
    {
        fwrite(pVoid, 1, nBytesRead, stream);
        free(pVoid);
    }

    //此时结尾可能还有一些内容，属于原来的ini文件
    //我们把它写成注释
    nPos = ftell(stream); //当前文件位置
    fclose(stream);

    //如果文件变小了，那么我们需要更改文件大小
    if(nPos < nFileEndPos)
    {
#ifdef WINCE    //WINCE平台
        HANDLE handle = CreateFile(
            lpFileName, //LPCTSTR lpFileName
            GENERIC_WRITE, //DOWRD dwDesiredAccess,
            0, //DWORD dwShareMode, 非共享模式
            NULL, //LPSECURITY_ATTRIBUTES lpSecurityAttributes, ignored
            OPEN_EXISTING, //DWORD dwCreationDispostion, 
            FILE_ATTRIBUTE_NORMAL, //DWORD dwFlagsAndAttributes, 
            NULL//HANDLE hTemplateFile, ignored
            ); 

        if(handle != NULL)
        {
            //移动文件指针
            SetFilePointer(handle, nPos, NULL, FILE_BEGIN);
            //设置EOF
            SetEndOfFile(handle);
            //关闭
            CloseHandle(handle);
        }

#else            //PC 平台
        int handle = t_sopen(lpFileName, _O_RDWR, _SH_DENYRW);
        if(handle > 0)
        {
            //修改文件大小
            _chsize(handle, nPos);
            //关闭文件
            _close(handle);
        }
#endif //
    }
    return TRUE;
}


//===========================================================
//        以下是我增加的函数（API中没有）
//===========================================================

//
//获取某个section下的所有的Key名，
//获取某个Section下面的所有“key形式的字符串集合，以0字符分割
//结尾使用两个0字符
//缓冲区写入："key1 \0 key2 \0 \0 "
//返回值表示写入缓冲区的字符数, 不包括结尾的0字符。
//如果缓冲区不够容纳所有的键值对，则返回值 = (nSize-2)

//注意：此函数是在桌面 API 中也没有的。而是我单独添加的
//
DWORD CeGetPrivateProfileKeyNames(
    LPCTSTR lpAppName,
    LPTSTR lpReturnedString,
    DWORD nSize,                //缓冲区的字符数
    LPCTSTR lpFileName
    )
{
    DWORD ret = 0;                    //返回值，拷贝的字符数量
    DWORD remainSize = nSize - 2;    //缓冲区当前所能能够接纳的字符数量
    DWORD copySize;                    //本次循环中需要拷贝的字符数量
    bool bFindSection = false;        //是否已经找到Section
    TCHAR line[ LINESIZE ];            //行缓冲区
    LPTSTR pItem;                    //指向当前键值对的写入地址
    TCHAR *pEqualChar;                //等号字符的在行中的位置
    FILE *stream;                    //流指针
    size_t sectionLength, lineLength;

    
    pItem = lpReturnedString; //指向缓冲区起始地址

    stream = t_fopen(lpFileName, _T("r"));
    if(stream == NULL)
    {
        return ret;
    }
    
    sectionLength = t_strlen(lpAppName);
    
    while(t_fgets(line, LINESIZE, stream) != NULL)
    {
        //缓冲区是否还有剩余空间？
        if(remainSize <= 0) break;

        //忽略注释行和空行
        if(line[0] == 0 || line[0] == ';') continue;
        lineLength = t_strlen(line);
        //注意：把LF（0xa）字符替换成0，这在UNICODE环境下可能出现结尾是LF）
        if(line[ lineLength - 1 ] == 0x0a)
        {
            line[ lineLength - 1 ] = 0;
            lineLength--;
            //注意此时可能会成为空字符串
            if(lineLength == 0) continue;
        }
        
        //尝试寻找到 section
        if(!bFindSection)
        {
            if(line[0] != '[') continue; //本行是否是 [section]
            //这里是我们想要的Section吗？
            //检查这一行的宽度是否正好是section长度加2， [lpAppName]
            if(line[sectionLength + 1] != ']') continue;
            if(t_strncmp(line+1, lpAppName, sectionLength) != 0) continue;
            //Now Section will appear on next line 
            bFindSection = true;            
            continue;
        }
        
        //查找Key, Section End?
        if(line[0]=='[') break; //遇到了下一个


        //copy the keyname to buffer, 注意ncpy不会复制结尾的0字符

        //LINE: "keyName = "
        //       |       |
        //     line   pEqualChar        

        //找出‘=’字符的位置
        pEqualChar = t_strchr(line, '=');
        if(pEqualChar != NULL)
        {
            //找到了‘=’字符，（pEqualChar - line）是key的长度
            copySize = min( remainSize,  pEqualChar - line );
        }
        else
        {
            //本行中不存在‘=’字符，对于合法文件来说不会出现此种情况
            copySize = min( remainSize, lineLength );
        }

        t_strncpy(pItem, line, copySize);
        //最佳一个0字符
        pItem[copySize] = 0;

        //缩小缓冲区剩余字符数量remainSize，和当前写入位置pItem
        ret += (copySize + 1); //加1是为了统计结尾的0字符
        remainSize -= (copySize + 1);
        pItem += (copySize + 1);
    }
    
    fclose(stream);

    if(bFindSection)
    {
        //再次对缓冲区追加一个0 字符
        *pItem = 0;
    }
    return ret;
}

      在 CeWritePrivateProfileString 函数中，用到的几个文件指针的含义是：假设我们要查找的 Section 是“section2”，Key 是“key2”；
      =============================
                                    ...
      nSectionBegin ->      [section2]
                                    ...
      nKeyBegin      ->      key2=value2
      nNextKey       ->      ...
                                    ...
      nNextSection  ->      [otherSection]
                                    ...
      =============================
      其他文件指针的含义是：nInsertPos - 新的KEY=Value开始写入位置； nCopyPos - 文件的后半部分在原始文件中的位置（整体不需要改写，但可能需要前移或后移），从这里到文件结尾的内容会在改写ini文件之前拷贝到内存，改写KEY后，再写回文件并附加到文件尾部。


　　上面的代码中，包含 StdAfx.h 通常是因为默认设定，如果取消预编译头的选项，则可以不包含它。
　　然后我们可以很方便对上面的代码进行测试：

#include <stdio.h>
#include "IniFile.h"

int _tmain(int argc, _TCHAR* argv[])
{
    TCHAR buffer[128];
    int age;

    CeGetPrivateProfileString(_T("section2"), _T("name"), _T("defaultValue"), buffer, t_strlen(buffer), _T("c:\\test.ini"));

    age = CeGetPrivateProfileInt(_T("section2"), _T("age"), -1, _T("c:\\test.ini"));

    //get section
    //CeGetPrivateProfileSection(_T("section2"), buffer, 128, _T("c:\\test.ini"));

    //key names
    CeGetPrivateProfileKeyNames(_T("section2"), buffer, 128, _T("c:\\test.ini"));

    //section names
    GetPrivateProfileSectionNames(buffer, 128, _T("c:\\test.ini"));

    CeWritePrivateProfileString(_T("section2"), _T("key2"), _T("testValue"), _T("c:\\test.ini"));

    wprintf(buffer);
    getchar();
    return 0;
}

//假设 C:\\test.ini 的内容是：
//;testing ini file
//[section1]
//key1=aa
//[section2]
//name=myname
//age=20
//[section3]
//key1=bb