C++博客-Dark Angle-随笔分类-Visual C++

C++的Json解析库：jsoncpp和boost

聂文龙 — Fri, 22 Mar 2013 05:53:00 GMT

JSON(JavaScript Object Notation)跟xml一样也是一种数据交换格式，了解json请参考其官网http://json.org，本文不再对json做介绍，将重点介绍c++的json解析库的使用方法。json官网上列出了各种语言对应的json解析库，作者仅介绍自己使用过的两种C++的json解析库:jsoncpp(v0.5.0)和Boost(v1.34.0)。

一. 使用jsoncpp解析json

Jsoncpp是个跨平台的开源库，首先从http://jsoncpp.sourceforge.net/上下载jsoncpp库源码，我下载的是v0.5.0，压缩包大约107K，解压，在jsoncpp-src-0.5.0/makefiles/vs71目录里找到jsoncpp.sln，用VS2003及以上版本编译，默认生成静态链接库。在工程中引用，只需要include/json及.lib文件即可。

使用JsonCpp前先来熟悉几个主要的类：

Json::Value 可以表示里所有的类型，比如int,string,object,array等，具体应用将会在后边示例中介绍。

Json::Reader 将json文件流或字符串解析到Json::Value, 主要函数有Parse。

Json::Writer 与Json::Reader相反，将Json::Value转化成字符串流，注意它的两个子类：Json::FastWriter和Json::StyleWriter，分别输出不带格式的json和带格式的json。

1. 从字符串解析json

[cpp] view plain copy print ?

int ParseJsonFromString()
{
const char* str = "{\"uploadid\": \"UP000000\",\"code\": 100,\"msg\": \"\",\"files\": \"\"}";
Json::Reader reader;
Json::Value root;
if (reader.parse(str, root)) // reader将Json字符串解析到root，root将包含Json里所有子元素
{
std::string upload_id = root["uploadid"].asString(); // 访问节点，upload_id = "UP000000"
int code = root["code"].asInt(); // 访问节点，code = 100
}
return 0;
}

int ParseJsonFromString()
{
  const char* str = "{\"uploadid\": \"UP000000\",\"code\": 100,\"msg\": \"\",\"files\": \"\"}";

  Json::Reader reader;
  Json::Value root;
  if (reader.parse(str, root))  // reader将Json字符串解析到root，root将包含Json里所有子元素
  {
    std::string upload_id = root["uploadid"].asString();  // 访问节点，upload_id = "UP000000"
    int code = root["code"].asInt();    // 访问节点，code = 100
  }
  return 0;
}

2. 从文件解析json

json文件内容：

[cpp] view plain copy print ?

{
"uploadid": "UP000000",
"code": "0",
"msg": "",
"files":
[
{
"code": "0",
"msg": "",
"filename": "1D_16-35_1.jpg",
"filesize": "196690",
"width": "1024",
"height": "682",
"images":
[
{
"url": "fmn061/20111118",
"type": "large",
"width": "720",
"height": "479"
},
{
"url": "fmn061/20111118",
"type": "main",
"width": "200",
"height": "133"
}
]
}
]
}

{
    "uploadid": "UP000000",
    "code": "0",
    "msg": "",
    "files":
    [
        {
            "code": "0",
            "msg": "",
            "filename": "1D_16-35_1.jpg",
            "filesize": "196690",
            "width": "1024",
            "height": "682",
            "images":
            [
                {
                    "url": "fmn061/20111118",
                    "type": "large",
                    "width": "720",
                    "height": "479"
                },
                {
                    "url": "fmn061/20111118",
                    "type": "main",
                    "width": "200",
                    "height": "133"
                }
            ]
        }
    ]
}

解析代码：

[cpp] view plain copy print ?

int ParseJsonFromFile(const char* filename)
{
// 解析json用Json::Reader
Json::Reader reader;
// Json::Value是一种很重要的类型，可以代表任意类型。如int, string, object, array...
Json::Value root;
std::ifstream is;
is.open (filename, std::ios::binary );
if (reader.parse(is, root))
{
std::string code;
if (!root["files"].isNull()) // 访问节点，Access an object value by name, create a null member if it does not exist.
code = root["uploadid"].asString();
// 访问节点，Return the member named key if it exist, defaultValue otherwise.
code = root.get("uploadid", "null").asString();
// 得到"files"的数组个数
int file_size = root["files"].size();
// 遍历数组
for(int i = 0; i < file_size; ++i)
{
Json::Value val_image = root["files"][i]["images"];
int image_size = val_image.size();
for(int j = 0; j < image_size; ++j)
{
std::string type = val_image[j]["type"].asString();
std::string url = val_image[j]["url"].asString();
}
}
}
is.close();
return 0;
}

int ParseJsonFromFile(const char* filename)
{
  // 解析json用Json::Reader
  Json::Reader reader;
  // Json::Value是一种很重要的类型，可以代表任意类型。如int, string, object, array...
  Json::Value root;       

  std::ifstream is;
  is.open (filename, std::ios::binary );  
  if (reader.parse(is, root))
  {
    std::string code;
    if (!root["files"].isNull())  // 访问节点，Access an object value by name, create a null member if it does not exist.
      code = root["uploadid"].asString();
    
    // 访问节点，Return the member named key if it exist, defaultValue otherwise.
    code = root.get("uploadid", "null").asString();

    // 得到"files"的数组个数
    int file_size = root["files"].size();

    // 遍历数组
    for(int i = 0; i < file_size; ++i)
    {
      Json::Value val_image = root["files"][i]["images"];
      int image_size = val_image.size();
      for(int j = 0; j < image_size; ++j)
      {
        std::string type = val_image[j]["type"].asString();
        std::string url = val_image[j]["url"].asString();
      }
    }
  }
  is.close();
  return 0;
}

3. 在json结构中插入json

[cpp] view plain copy print ?

Json::Value arrayObj; // 构建对象
Json::Value new_item, new_item1;
new_item["date"] = "2011-12-28";
new_item1["time"] = "22:30:36";
arrayObj.append(new_item); // 插入数组成员
arrayObj.append(new_item1); // 插入数组成员
int file_size = root["files"].size();
for(int i = 0; i < file_size; ++i)
root["files"][i]["exifs"] = arrayObj; // 插入原json中

    Json::Value arrayObj;   // 构建对象
    Json::Value new_item, new_item1;
    new_item["date"] = "2011-12-28";
    new_item1["time"] = "22:30:36";
    arrayObj.append(new_item);  // 插入数组成员
    arrayObj.append(new_item1); // 插入数组成员
    int file_size = root["files"].size();
    for(int i = 0; i < file_size; ++i)
      root["files"][i]["exifs"] = arrayObj;   // 插入原json中

4. 输出json

[cpp] view plain copy print ?

// 转换为字符串（带格式）
std::string out = root.toStyledString();
// 输出无格式json字符串
Json::FastWriter writer;
std::string out2 = writer.write(root);

// 转换为字符串（带格式）
std::string out = root.toStyledString();
// 输出无格式json字符串
Json::FastWriter writer;
std::string out2 = writer.write(root);

二. 使用Boost property_tree解析json

property_tree可以解析xml，json，ini，info等格式的数据，用property_tree解析这几种格式使用方法很相似。

解析json很简单，命名空间为boost::property_tree，reson_json函数将文件流、字符串解析到ptree，write_json将ptree输出为字符串或文件流。其余的都是对ptree的操作。

解析json需要加头文件：

#include
#include

1. 解析json

解析一段下面的数据：

[html] view plain copy print ?

{
"code": 0,
"images":
[
{
"url": "fmn057/20111221/1130/head_kJoO_05d9000251de125c.jpg"
},
{
"url": "fmn057/20111221/1130/original_kJoO_05d9000251de125c.jpg"
}
]
}

{
  "code": 0,
  "images":
  [
    {
      "url": "fmn057/20111221/1130/head_kJoO_05d9000251de125c.jpg"
    },
    {
      "url": "fmn057/20111221/1130/original_kJoO_05d9000251de125c.jpg"
    }
  ]
}

[cpp] view plain copy print ?

int ParseJson()
{
std::string str = "{\"code\":0,\"images\":[{\"url\":\"fmn057/20111221/1130/head_kJoO_05d9000251de125c.jpg\"},{\"url\":\"fmn057/20111221/1130/original_kJoO_05d9000251de125c.jpg\"}]}";
using namespace boost::property_tree;
std::stringstream ss(str);
ptree pt;
try{
read_json(ss, pt);
}
catch(ptree_error & e) {
return 1;
}
try{
int code = pt.get<int>("code"); // 得到"code"的value
ptree image_array = pt.get_child("images"); // get_child得到数组对象
// 遍历数组
BOOST_FOREACH(boost::property_tree::ptree::value_type &v, image_array)
{
std::stringstream s;
write_json(s, v.second);
std::string image_item = s.str();
}
}
catch (ptree_error & e)
{
return 2;
}
return 0;
}

int ParseJson()
{
  std::string str = "{\"code\":0,\"images\":[{\"url\":\"fmn057/20111221/1130/head_kJoO_05d9000251de125c.jpg\"},{\"url\":\"fmn057/20111221/1130/original_kJoO_05d9000251de125c.jpg\"}]}";
  using namespace boost::property_tree;

  std::stringstream ss(str);
  ptree pt;
  try{    
    read_json(ss, pt);
  }
  catch(ptree_error & e) {
    return 1; 
  }

  try{
    int code = pt.get("code");   // 得到"code"的value
    ptree image_array = pt.get_child("images");  // get_child得到数组对象
    
    // 遍历数组
    BOOST_FOREACH(boost::property_tree::ptree::value_type &v, image_array)
    {
      std::stringstream s;
      write_json(s, v.second);
      std::string image_item = s.str();
    }
  }
  catch (ptree_error & e)
  {
    return 2;
  }
  return 0;
}

2. 构造json

[cpp] view plain copy print ?

int InsertJson()
{
std::string str = "{\"code\":0,\"images\":[{\"url\":\"fmn057/20111221/1130/head_kJoO_05d9000251de125c.jpg\"},{\"url\":\"fmn057/20111221/1130/original_kJoO_05d9000251de125c.jpg\"}]}";
using namespace boost::property_tree;
std::stringstream ss(str);
ptree pt;
try{
read_json(ss, pt);
}
catch(ptree_error & e) {
return 1;
}
// 修改/增加一个key-value，key不存在则增加
pt.put("upid", "00001");
// 插入一个数组
ptree exif_array;
ptree array1, array2, array3;
array1.put("Make", "NIKON");
array2.put("DateTime", "2011:05:31 06:47:09");
array3.put("Software", "Ver.1.01");
exif_array.push_back(std::make_pair("", array1));
exif_array.push_back(std::make_pair("", array2));
exif_array.push_back(std::make_pair("", array3));
// exif_array.push_back(std::make_pair("Make", "NIKON"));
// exif_array.push_back(std::make_pair("DateTime", "2011:05:31 06:47:09"));
// exif_array.push_back(std::make_pair("Software", "Ver.1.01"));
pt.put_child("exifs", exif_array);
std::stringstream s2;
write_json(s2, pt);
std::string outstr = s2.str();
return 0;
}

int InsertJson()
{
  std::string str = "{\"code\":0,\"images\":[{\"url\":\"fmn057/20111221/1130/head_kJoO_05d9000251de125c.jpg\"},{\"url\":\"fmn057/20111221/1130/original_kJoO_05d9000251de125c.jpg\"}]}";
  using namespace boost::property_tree;

  std::stringstream ss(str);
  ptree pt;
  try{    
    read_json(ss, pt);
  }
  catch(ptree_error & e) {
    return 1; 
  }

  // 修改/增加一个key-value，key不存在则增加
  pt.put("upid", "00001");

  // 插入一个数组
  ptree exif_array;
  ptree array1, array2, array3;
  array1.put("Make", "NIKON");
  array2.put("DateTime", "2011:05:31 06:47:09");
  array3.put("Software", "Ver.1.01");
  exif_array.push_back(std::make_pair("", array1));
  exif_array.push_back(std::make_pair("", array2));
  exif_array.push_back(std::make_pair("", array3));

//   exif_array.push_back(std::make_pair("Make", "NIKON"));
//   exif_array.push_back(std::make_pair("DateTime", "2011:05:31 06:47:09"));
//   exif_array.push_back(std::make_pair("Software", "Ver.1.01"));

  pt.put_child("exifs", exif_array);
  std::stringstream s2;
  write_json(s2, pt);
  std::string outstr = s2.str();

  return 0;
}

三. 两种解析库的使用经验

1. 用boost::property_tree解析字符串遇到"\/"时解析失败，而jsoncpp可以解析成功，要知道'/'前面加一个'\'是JSON标准格式。

2. boost::property_tree的read_json和write_json在多线程中使用会引起崩溃。

针对1，可以在使用boost::property_tree解析前写个函数去掉"\/"中的'\'，针对2，在多线程中同步一下可以解决。

我的使用心得：使用boost::property_tree不仅可以解析json，还可以解析xml，info等格式的数据。对于解析json，使用boost::property_tree解析还可以忍受，但解析xml，由于遇到问题太多只能换其它库了。

聂文龙 2013-03-22 13:53 发表评论

CString 常用操作种种

聂文龙 — Mon, 18 Mar 2013 13:58:00 GMT

摘要: //A.构造函数，CStringT提供了19个构造函数，其中一个旨在.NET平台托管C++工程中才被编译，我只写几个我觉得常用的 //1.默认构造函数，生成一个""字符串 CString cstr1; //2.拷贝构造函数 CString cstr2(cstr1); /... 阅读全文

聂文龙 2013-03-18 21:58 发表评论

SQL 文本导入方式 bcp OpenRowset opendatasource BULK INSERT

聂文龙 — Mon, 18 Mar 2013 13:11:00 GMT

select * from OpenRowset('MSDASQL', 'Driver={Microsoft Text Driver (*.txt; *.csv)};DefaultDir=C:\Users\Administrator\Desktop;','select * from Num.txt')

select * from opendatasource('MICROSOFT.JET.OLEDB.4.0','Text;DATABASE=C:\Users\Administrator\Desktop')...[Num.txt]

BULK INSERT master..Temp FROM 'C:\Users\Administrator\Desktop\Num.txt' WITH ( FIELDTERMINATOR =' ', ROWTERMINATOR= '\n')

/** 导入文本文件
EXEC master..xp_cmdshell 'bcp dbname..tablename in c:\DT.txt -c -Sservername -Usa -Ppassword'

/** 导出文本文件
EXEC master..xp_cmdshell 'bcp dbname..tablename out c:\DT.txt -c -Sservername -Usa -Ppassword'
或
EXEC master..xp_cmdshell 'bcp "Select * from dbname..tablename" queryout c:\DT.txt -c -Sservername -Usa -Ppassword'

导出到TXT文本，用逗号分开
exec master..xp_cmdshell 'bcp "库名..表名" out "d:\tt.txt" -c -t ,-U sa -P password'

在做一些web数据库管理系统的时候经常要实现将帐户批量注册的功能，今天就来讲讲如何在C#-web项目中将txt文件和excel文件导入SQL2000数据库。
1.数据库准备
在SQL2000数据库的实例数据库pubs中建立一个数据表txtInsert，字段很简单：id，name两个。
2.txt文本文件导入
对于数据文件导入与导出SQL2000提供了BULK INSERT和BCP语句，在这里可以使用BULK INSERT命令实现。假设在c盘上有一个文本文件stu.txt内容为：
    1,tom
    2,jack
    3,jhon
    ......
实现导入的C#代码如下：
protected System.Web.UI.HtmlControls.HtmlInputFile fName;
protected System.Web.UI.WebControls.Button BtnInsert;
//上面两个控件自己添加

private void BtnInsert_Click(object sender, System.EventArgs e)
  {
                string fPath=this.fName.PostedFile.FileName;//获得要导入的文本文件
            string extName=fPath.Substring(fPath.LastIndexOf(".")+1);//获得文件的扩展名
            SqlConnection con=new SqlConnection("server=.;database=pubs;uid=sa;pwd=;");//数据库连接对象
            con.Open();
            try
      {
                    SqlCommand com=new SqlCommand("BULK INSERT pubs.dbo.txtInsert FROM '"+fPath+"' WITH  (FIELDTERMINATOR = ',',ROWTERMINATOR= '\n')",con);
                       //其中的FIELDTERMINATOR=','指明字段间所使用的分隔符为逗号
                       //其中ROWTERMINATOR= '\n'指明记录间所使用的分隔符为回车
                    com.ExecuteNonQuery();
                    Response.Write("alert('数据导入成功!')");
                }
             catch (SqlException SQLexc)
                {
                    Response.Write("导入数据库时出错：" + SQLexc.ToString());
                }
con.Close();
}

好了，这个txt文件的导入相对简单，在数据库中我也没有设置主键，我在里面也没有加出错回滚事务操作，在下面的excel文件的导入中介绍。
3.excel文件的导入
在c盘里建立一个stu.xls文件，在sheet1工作表中有两列数据如下：
     编号姓名
     1        tom
     2        jack
     3        john
     ......
注意，工作表的第一行是作为标题行的不会被插入到数据库中，真正导入从第二行开始。
为了演示事物出错回滚，在这里将txtInsert数据库表中的id字段设置为主键。实现的C#代码如下：

private void BtnInsert_Click(object sender, System.EventArgs e)
  {
   string fPath=this.fName.PostedFile.FileName;//获得要导入的文本文件
   string extName=fPath.Substring(fPath.LastIndexOf(".")+1);//获得文件的扩展名
   SqlConnection con=new SqlConnection("server=.;database=pubs;uid=sa;pwd=;");//数据库连接对象
   con.Open();
    //注意下面的连接字符串，是它起到了导入的作用
    SqlCommand excelCmd=new SqlCommand("insert into txtInsert select * from OPENROWSET('MICROSOFT.JET.OLEDB.4.0','Excel 5.0;HDR=YES;DATABASE="+fPath+"',Sheet1$)",con);
    SqlTransaction myTran=con.BeginTransaction();//开始一个事务操作
    excelCmd.Transaction=myTran;
    try
    {
     excelCmd.ExecuteNonQuery();
     myTran.Commit();//提交事务
     Response.Write("alert('数据导入成功!')");
    }
    catch (SqlException err)
    {
     myTran.Rollback(); //出错回滚事务操作
     //以下三行是去掉数据库出错信息中的非法字符单引号、回车和换行符，否则在使用时javascript代码将有语法错误
     //因为js的编码和c#的编码不同
     string errString=err.Message.Replace("'"," ");
     errString=errString.Replace(Convert.ToChar(13).ToString(),"");
     errString=errString.Replace(Convert.ToChar(10).ToString(),"");
     //显示出错信息框
     Response.Write("alert('导入数据库时出错!详细信息:"+errString+"')");
    }
   con.Close();
  }

这里“显示出错信息框”开始我没有田间那三行代码，结果搞了半天，最后还是在html文件中发现javascript代码部分出现了分行，老是提示“未结束的字符串常量”，所以导致不能打开信息框，郁闷死我了，花了好多时间。
4.将excel中部分列导入数据库的方法
上面讲了关于将整个excel文件导入数据库的方法，那么在实际项目中遇到将excel文件中若干列导入数据库怎么办的呢，原理差不多，我就将代码直接给出了：

                   string  fPath=this.fName.PostedFile.FileName;//获得要导入的文本文件
                   string  extName=fPath.Substring(fPath.LastIndexOf(".")+1);//获得文件的扩展名
                   SqlConnection con=new SqlConnection("server=.;database=pubs;uid=sa;pwd=;");//数据库连接对象
                   con.Open();
                   string mystring="Provider = Microsoft.Jet.OLEDB.4.0 ; Data Source = '"+fPath+"';Extended Properties=Excel 8.0";
                OleDbConnection cnnxls = new OleDbConnection (mystring);
                OleDbDataAdapter myDa =new OleDbDataAdapter("select * from [Sheet1$]",cnnxls);
                DataSet myDs =new DataSet();
                myDa.Fill(myDs);
                if(myDs.Tables[0].Rows.Count > 0)
                {
                    string strSql = "";
                    string CnnString="Provider=SQLOLEDB;database=pubs;server=.;uid=sa;pwd=";
                    OleDbConnection conn =new OleDbConnection(CnnString);
                    conn.Open ();
                    OleDbCommand myCmd =null;
                    for(int i=0; i<myDs.Tables[0].Rows.Count;i++)//第一个工作表中行数，不包括第一行，
                    {
                        strSql="insert into txtInsert(id,name) values (";
                        strSql += myDs.Tables[0].Rows[i].ItemArray[0].ToString() + ", '";
                        strSql += myDs.Tables[0].Rows[i].ItemArray[1].ToString() + "')";
                        myCmd=new OleDbCommand(strSql,conn);
                        try
                        {
                            myCmd.ExecuteNonQuery();
                            Response.Write("alert('数据导入成功!')");
                        }
                        catch (OleDbException err)
                        {
                            Response.Write("导入数据库时出错：" +err.ToString());
                            break;
                        }
                    }
                    conn.Close();

其他部分代码自己加吧，这里就是出错失误回滚有点不好处理，请高手指教！！

聂文龙 2013-03-18 21:11 发表评论

VC控件ListCtrl的使用方法总汇

聂文龙 — Mon, 18 Mar 2013 07:19:00 GMT

以下未经说明，listctrl默认view 风格为report
-------------------------------------------------------------------------------
1. CListCtrl 风格
       LVS_ICON: 为每个item显示大图标
       LVS_SMALLICON: 为每个item显示小图标
       LVS_LIST: 显示一列带有小图标的item
       LVS_REPORT: 显示item详细资料
直观的理解：windows资源管理器，"查看"标签下的"大图标，小图标，列表，详细资料
--------------------------------------------------------------------------------
2. 设置listctrl 风格及扩展风格
       LONG lStyle;
       lStyle = GetWindowLong(m_list.m_hWnd, GWL_STYLE);//获取当前窗口style
       lStyle &= ~LVS_TYPEMASK; //清除显示方式位
       lStyle |= LVS_REPORT; //设置style
       SetWindowLong(m_list.m_hWnd, GWL_STYLE, lStyle);//设置style
       DWORD dwStyle = m_list.GetExtendedStyle();
       dwStyle |= LVS_EX_FULLROWSELECT;//选中某行使整行高亮（只适用与report风格的listctrl）
dwStyle |= LVS_EX_GRIDLINES;//网格线（只适用与report风格的listctrl）
dwStyle |= LVS_EX_CHECKBOXES;//item前生成checkbox控件
m_list.SetExtendedStyle(dwStyle); //设置扩展风格
注：listview的style请查阅msdn
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wceshellui5/html/wce50lrflistviewstyles.asp
--------------------------------------------------------------------------------
3. 插入数据
       m_list.InsertColumn( 0, "ID", LVCFMT_LEFT, 40 );//插入列
       m_list.InsertColumn( 1, "NAME", LVCFMT_LEFT, 50 );

      //新插入的在上面
       int nRow = m_list.InsertItem(0, "11");// 插入行
       m_list.SetItemText(nRow, 1, "jacky");//设置其它列数据

//新插入的数据在下面

   int nIndex = m_list.GetItemCount();
    LV_ITEM lvItem;
    lvItem.mask = LVIF_TEXT ;
    lvItem.iItem = nIndex;     //行数
    lvItem.iSubItem = 0;
    lvItem.pszText = (char*)(LPCTSTR)strCount;   //第一列
    //在最后一行插入记录值.
         m_list.InsertItem(&lvItem);
    //插入其它列
    m_list.SetItemText(nIndex,1,strLat);
--------------------------------------------------------------------------------
4. 一直选中item
选中style中的Show selection always，或者在上面第2点中设置LVS_SHOWSELALWAYS
--------------------------------------------------------------------------------
5. 选中和取消选中一行
int nIndex = 0;
//选中
m_list.SetItemState(nIndex, LVIS_SELECTED|LVIS_FOCUSED, LVIS_SELECTED|LVIS_FOCUSED);
//取消选中
     m_list.SetItemState(nIndex, 0, LVIS_SELECTED|LVIS_FOCUSED);
--------------------------------------------------------------------------------
6. 得到listctrl中所有行的checkbox的状态
m_list.SetExtendedStyle(LVS_EX_CHECKBOXES);
CString str;
for(int i=0; i
{
if( m_list.GetItemState(i, LVIS_SELECTED) == LVIS_SELECTED || m_list.GetCheck(i))
{
str.Format(_T("第%d行的checkbox为选中状态"), i);
AfxMessageBox(str);
}
}
--------------------------------------------------------------------------------
7. 得到listctrl中所有选中行的序号
方法一：
       CString str;
       for(int i=0; i
       {
           if( m_list.GetItemState(i, LVIS_SELECTED) == LVIS_SELECTED )
           {
                 str.Format(_T("选中了第%d行"), i);
                 AfxMessageBox(str);
           }
       }
方法二：
       POSITION pos = m_list.GetFirstSelectedItemPosition();
       if (pos == NULL)
           TRACE0("No items were selected!\n");
       Else
       {
           while (pos)
           {
                 int nItem = m_list.GetNextSelectedItem(pos);
                 TRACE1("Item %d was selected!\n", nItem);
                 // you could do your own processing on nItem here
           }
       }
--------------------------------------------------------------------------------
8. 得到item的信息
       TCHAR szBuf[1024];
       LVITEM lvi;
       lvi.iItem = nItemIndex;
       lvi.iSubItem = 0;
       lvi.mask = LVIF_TEXT;
       lvi.pszText = szBuf;
       lvi.cchTextMax = 1024;
       m_list.GetItem(&lvi);
关于得到设置item的状态，还可以参考msdn文章
       Q173242: Use Masks to Set/Get Item States in ClistCtrl
http://support.microsoft.com/kb/173242/en-us
--------------------------------------------------------------------------------
9. 得到listctrl的所有列的header字符串内容
       LVCOLUMN lvcol;
       char   str[256];
       int   nColNum;
       CString   strColumnName[4];//假如有4列
       nColNum = 0;
       lvcol.mask = LVCF_TEXT;
       lvcol.pszText = str;
       lvcol.cchTextMax = 256;
       while(m_list.GetColumn(nColNum, &lvcol))
       {
           strColumnName[nColNum] = lvcol.pszText;
           nColNum++;
       }
--------------------------------------------------------------------------------
10. 使listctrl中一项可见，即滚动滚动条
m_list.EnsureVisible(i, FALSE);
--------------------------------------------------------------------------------
11. 得到listctrl列数
int nHeadNum = m_list.GetHeaderCtrl()->GetItemCount();
--------------------------------------------------------------------------------
12. 删除所有列
方法一：
         while ( m_list.DeleteColumn (0))
因为你删除了第一列后，后面的列会依次向上移动。
方法二：
       int nColumns = 4;
       for (int i=nColumns-1; i>=0; i--)
           m_list.DeleteColumn (i);
--------------------------------------------------------------------------------
13. 得到单击的listctrl的行列号
添加listctrl控件的NM_CLICK消息相应函数
       void CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)
       {
           // 方法一：
           /*
           DWORD dwPos = GetMessagePos();
           CPoint point( LOWORD(dwPos), HIWORD(dwPos) );
           m_list.ScreenToClient(&point);
           LVHITTESTINFO lvinfo;
           lvinfo.pt = point;
           lvinfo.flags = LVHT_ABOVE;
           int nItem = m_list.SubItemHitTest(&lvinfo);
           if(nItem != -1)
           {
                 CString strtemp;
                 strtemp.Format("单击的是第%d行第%d列", lvinfo.iItem, lvinfo.iSubItem);
                 AfxMessageBox(strtemp);
           }
           */
         // 方法二:
           /*
           NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
           if(pNMListView->iItem != -1)
           {
                 CString strtemp;
                 strtemp.Format("单击的是第%d行第%d列",
                                 pNMListView->iItem, pNMListView->iSubItem);
                 AfxMessageBox(strtemp);
           }
           */
           *pResult = 0;
       }
--------------------------------------------------------------------------------
14. 判断是否点击在listctrl的checkbox上
添加listctrl控件的NM_CLICK消息相应函数
       void CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)
{
DWORD dwPos = GetMessagePos();
           CPoint point( LOWORD(dwPos), HIWORD(dwPos) );
           m_list.ScreenToClient(&point);
           LVHITTESTINFO lvinfo;
           lvinfo.pt = point;
           lvinfo.flags = LVHT_ABOVE;
           UINT nFlag;
           int nItem = m_list.HitTest(point, &nFlag);
           //判断是否点在checkbox上
           if(nFlag == LVHT_ONITEMSTATEICON)
           {
                 AfxMessageBox("点在listctrl的checkbox上");
           }
           *pResult = 0;
       }
--------------------------------------------------------------------------------
15. 右键点击listctrl的item弹出菜单
添加listctrl控件的NM_RCLICK消息相应函数
       void CTest6Dlg::OnRclickList1(NMHDR* pNMHDR, LRESULT* pResult)
       {
           NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
           if(pNMListView->iItem != -1)
           {
                 DWORD dwPos = GetMessagePos();
                 CPoint point( LOWORD(dwPos), HIWORD(dwPos) );
                 CMenu menu;
                 VERIFY( menu.LoadMenu( IDR_MENU1 ) );
                 CMenu* popup = menu.GetSubMenu(0);
                 ASSERT( popup != NULL );
               popup->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON, point.x, point.y, this );
           }
           *pResult = 0;
   }

16. item切换焦点时(包括用键盘和鼠标切换item时)，状态的一些变化顺序
添加listctrl控件的LVN_ITEMCHANGED消息相应函数
       void CTest6Dlg::OnItemchangedList1(NMHDR* pNMHDR, LRESULT* pResult)
       {
           NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR;
           // TODO: Add your control notification handler code here
           CString sTemp;
           if((pNMListView->uOldState & LVIS_FOCUSED) == LVIS_FOCUSED && (pNMListView->uNewState & LVIS_FOCUSED) == 0)
           {
                 sTemp.Format("%d losted focus",pNMListView->iItem);
           }
           else if((pNMListView->uOldState & LVIS_FOCUSED) == 0 &&
               (pNMListView->uNewState & LVIS_FOCUSED) == LVIS_FOCUSED)
           {
                 sTemp.Format("%d got focus",pNMListView->iItem);
           }
           if((pNMListView->uOldState & LVIS_SELECTED) == LVIS_SELECTED &&
             (pNMListView->uNewState & LVIS_SELECTED) == 0)
           {
                 sTemp.Format("%d losted selected",pNMListView->iItem);
           }
else if((pNMListView->uOldState & LVIS_SELECTED) == 0 && (pNMListView->uNewState & LVIS_SELECTED) == LVIS_SELECTED)
           {
sTemp.Format("%d got selected",pNMListView->iItem);
}
*pResult = 0;
--------------------------------------------------------------------------------
17. 得到另一个进程里的listctrl控件的item内容
http://www.codeproject.com/threads/int64_memsteal.asp

--------------------------------------------------------------------------------
18. 选中listview中的item
Q131284: How To Select a Listview Item Programmatically
http://support.microsoft.com/kb/131284/en-us

--------------------------------------------------------------------------------
19. 如何在CListView中使用CListCtrl的派生类
http://www.codeguru.com/cpp/controls/listview/introduction/article.php/c919/

--------------------------------------------------------------------------------
20. listctrl的subitem添加图标
       m_list.SetExtendedStyle(LVS_EX_SUBITEMIMAGES);
       m_list.SetItem(..); //具体参数请参考msdn

聂文龙 2013-03-18 15:19 发表评论

利用ICMP和RAS（Remote Access Service）进行的一些网络操作

聂文龙 — Sun, 17 Mar 2013 12:10:00 GMT

首先是用ICMP检查网络是否连通：

bool Util::CheckInternet()
{
    char *SendData = "Data Buffer";
    LPVOID ReplyBuffer;
    DWORD dwRetVal;
    HANDLE hIcmpFile;
    bool b=false;
    if ((hIcmpFile = IcmpCreateFile()) == INVALID_HANDLE_VALUE)
        return false;

    ReplyBuffer = (VOID*) malloc(sizeof(ICMP_ECHO_REPLY) + sizeof(SendData));
    if ((dwRetVal = IcmpSendEcho(hIcmpFile,
        inet_addr("209.131.36.158"), //用的雅虎的一个IP，可能延迟会大一点，用国内的会小一点
        SendData, sizeof(SendData),
        NULL, ReplyBuffer,
        sizeof(ReplyBuffer) + sizeof(ICMP_ECHO_REPLY),
        1000)) != 0) {
        b=true;
    }
    free(ReplyBuffer);
    return b;
}

很简单的几行代码，没有注释；
如果网络不通的话枚举拨号连接，进行拨号：

bool RASManager::ConnectNetwork()
{
    RASENTRYNAME Entries[15];
    DWORD cb,cEntries,dwRet;
    Entries[0].dwSize=sizeof(RASENTRYNAME);
    cb=sizeof(Entries);
    cEntries=0;

    dwRet=::RasEnumEntries(NULL, NULL, &Entries[0], &cb, &cEntries);//如果函数成功，则返回0

    if(dwRet == 0)
    {
        CHAR  szRasEntryName[RAS_MaxEntryName + 1]={0};
        for(UINT i=0;i<cEntries;i++)
            strcpy(szRasEntryName,Entries[i].szEntryName);
        RASDIALPARAMS rdParams;
        DWORD dwRet;
        hConn=NULL;
        rdParams.dwSize=sizeof(RASDIALPARAMS);
        strcpy(rdParams.szEntryName,szRasEntryName);
        strcpy(rdParams.szPhoneNumber,"#777");//我用的3G卡，拨#777号码
        strcpy(rdParams.szUserName,"用户名");
        strcpy(rdParams.szPassword,"密码");
        strcpy(rdParams.szDomain,"");//这个也很重要，指定域，如果不指定这个的话下面注释的两句一定要加上，下边两句的意思是获取最后一次连接成功时的参数信息，如果用下边两句的话连同这行和这行上面的三行都可以省略
       // BOOL fPass;
        //RasGetEntryDialParams(NULL, &rdParams,&fPass);
        dwRet=RasDial(NULL,NULL,&rdParams,0L,NULL,&hConn);
        if(dwRet!=0)
        {
            return false;
        }
        return true;
    }
    else
    {
        return false;
    }
}

预先建立拨号连接，以上拨号代码经过修改已经不需要保存密码，只建立一个拨号连接即可。Windows XP or later: Do not use the RasSetEntryDialParams function. MSDN上面的说法就是RasSetEntryDialParams 别在XP之后的系统上使用了。
检查拨号连接的状态，如果已经通过拨号连接上了网络当然不用再进行拨号了，代码如下：

bool RASManager::RasGetConnectStatus()
{
    LPRASCONN lpRasConn = NULL;
    DWORD   cbBuf   =   0;
    DWORD   cConn   =   0;
    DWORD   dwRet   =   0;
    HRASCONN  hrasconn;
    bool    bResult=FALSE;
    RASCONNSTATUS rasStatus;
    UINT   ndx;
    cbBuf = sizeof(RASCONN);
    lpRasConn = (LPRASCONN)malloc((UINT)cbBuf);
    if (lpRasConn != NULL)
    {
        lpRasConn->dwSize = sizeof(RASCONN);
        dwRet = RasEnumConnections(lpRasConn,&cbBuf,&cConn);
        for(ndx=0;ndx<cConn;ndx++)
        {
            hrasconn = lpRasConn[ndx].hrasconn;
            rasStatus.dwSize = sizeof(RASCONNSTATUS);
            dwRet = ::RasGetConnectStatus(hrasconn,&rasStatus);
            if(dwRet)
                bResult=FALSE;
            else
            {
                if(rasStatus.rasconnstate == RASCS_Connected)
                    bResult=TRUE;
                else
                    bResult=FALSE;
            }
        }
    }
    else
        bResult=FALSE;
    free(lpRasConn);
    return bResult;
}

以上判断是如果检查到有一个已经连接的拨号连接就返回了，应该不会有两个或者以上的拨号连接同时连接，打开端口会失败的。
还有一个是断线：

void RASManager::HungUP()
{
    LPRASCONN lpRasConn=NULL;
    DWORD   cbBuf = 0;
    DWORD   cConn = 0;
    DWORD   dwRet = 0;
    HRASCONN   hrasconn;
    RASCONNSTATUS rasStatus;
    UINT   ndx;

    cbBuf = sizeof(RASCONN);
    lpRasConn = (LPRASCONN)malloc((UINT)cbBuf);
    if(lpRasConn != NULL)
    {
        lpRasConn->dwSize = sizeof(RASCONN);
        dwRet = RasEnumConnections(lpRasConn,&cbBuf,&cConn);

        for(ndx=0;ndx<cConn;ndx++)
        {
            hrasconn = lpRasConn[ndx].hrasconn;
            rasStatus.dwSize = sizeof(RASCONNSTATUS);
            dwRet = ::RasGetConnectStatus(hrasconn,&rasStatus);
            if(!dwRet)
            {
                if(rasStatus.rasconnstate == RASCS_Connected)
                    RasHangUp(hrasconn);
            }
        }
        free(lpRasConn);
    }
}

这个没什么好说的，执行关闭拨号连接的操作。
用程序创建连接，经过修改，已经可以正常创建连接，代码如下：

bool RASManager::CreateRASLink()
{
    LPRASENTRY lpRasEntry = NULL;
    DWORD cb = sizeof(RASENTRY);
    DWORD dwBufferSize = 0;
    DWORD dwRet = 0;


    // 取得entry的大小,这句也不知道是不是必须的,因为sizeof(RASENTRY)和这里取到的dwBufferSize是一样的,不过还是Get一下安全点
    RasGetEntryProperties(NULL,"", NULL, &dwBufferSize, NULL, NULL);
    if (dwBufferSize == 0)
        return false;

    lpRasEntry = (LPRASENTRY)HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, dwBufferSize);
    if (lpRasEntry == NULL)
        return false;

    ZeroMemory(lpRasEntry, sizeof(RASENTRY));
    lpRasEntry->dwSize = dwBufferSize;
    lpRasEntry->dwfOptions = RASEO_RemoteDefaultGateway|RASEO_PreviewPhoneNumber|RASEO_PreviewUserPw; // 这里的几个选项挺重要的，RASEO_RemoteDefaultGateway这个选项把创建的连接设置为默认连接，RASEO_PreviewPhoneNumber对应选项中的提示输入电话号码，RASEO_PreviewUserPw对应选项中的提示用户名和密码
    lpRasEntry->dwType = RASET_Phone;

    lstrcpy(lpRasEntry->szDeviceType, RASDT_Modem);
    lstrcpy(lpRasEntry->szDeviceName,"www");
    lpRasEntry->dwfNetProtocols = RASNP_Ip;
    lpRasEntry->dwFramingProtocol = RASFP_Ppp;

    dwRet = RasSetEntryProperties(NULL, "www", lpRasEntry, dwBufferSize, NULL, 0); // 创建连接
//The RasSetEntryProperties function changes the connection information for an entry in the phone book or creates a new phone-book entry.（reference MSDN）
    HeapFree(GetProcessHeap(), 0, (LPVOID)lpRasEntry);

    if (dwRet != 0)
        return false;
    return true;
}

上面的代码到是可以创建一个拨号连接，不过是个空的，里面没用用户名和密码等信息，需要用上面的拨号代码来指定拨号参数，不能使用RasGetEntryDialParams来获取了。
上面的代码基本上是在网络上搜索所得，稍加修改，在这里整理一下。

再补充一下删除连接的操作,代码如下：

void RASManager::DeletePhoneBookEntry()
{
    RASENTRYNAME Entries[15];
    DWORD cb,cEntries,dwRet;
    Entries[0].dwSize=sizeof(RASENTRYNAME);
    cb=sizeof(Entries);
    cEntries=0;

    dwRet=::RasEnumEntries(NULL, NULL, &Entries[0], &cb, &cEntries);//如果函数成功，则返回0

    if(dwRet == 0)
    {
        CHAR  szRasEntryName[RAS_MaxEntryName + 1]={0};
        for(UINT i=0;i<cEntries;i++)
        {
            strcpy(szRasEntryName,Entries[i].szEntryName);
            RasDeleteEntry(NULL,szRasEntryName);
        }
    }
}

要想实现自动启动拨号网络，就要使用Remote Access Service (RAS) API，这个API最早是在Windows for Workgroup 3.11中出现的，现在它已经成为Win32 API的一个组成部分。该API将整个拨号网络称为Phonebook，而每一个连接称为PhonebookEntry。你可以使用RasCreatePhonebookEntry来创建新的连接，用RasDial来拨号，而RasEnumEntries可以获得当前系统已有的所有连接，使用其它的RAS函数还可以获取或设置连接的参数。 RasEditPhonebookEntry函数将激活标准的Windows 95/NT属性对话框来修改连接的属性。你可以从Win32 API的手册找到所有相关函数的详细介绍。

补充：在windows中一个拨号连接即为一个PhonrbookEntry以下称为电话薄记录或是连接。总的这些称为Phonebook。

聂文龙 2013-03-17 20:10 发表评论

VC＋＋实现拨号连接及动态IP地址获取

聂文龙 — Sun, 17 Mar 2013 11:51:00 GMT

　　在Win32 API 函数中有一组用于实现远程连接服务RAS 的函数，利用这些函数通过编程可以实现建立和Internet 的拨号连接，并可获得Internet 分配给主机的动态IP 地址。

一、建立拨号连接API

　　建立拨号连接是利用函数RasDial() 实现的，该函数调用后立即返回，若成功返回0 值，否则返回非0 值。在拨号连接过程中，回调函数接收连接的状态信息及发生的错误代码。回调函数的原形如下：VOID WINAPI RasDialFunc(UINT unMsg,RASCONNSTATE rasconnstate,DWORD dwError)
　　由于在调用RasDialFunc 函数时，连接操作被挂起，因此，应用程序应尽快处理发生的事件并返回。可以在RasDialFunc 函数中调用PostMessage 函数，将事件通知消息送给窗口函数来处理。

　　RASDIALPARAMS 结构定义如下：

　　DWORD dwSize 结构变量的大小。

　　TCHAR szEntryName[RAS_MaxEntryName ＋1] 　拨号网络中建立的连接名。

　　TCHAR szPhoneNumber[RAS_MaxPhoneNumber ＋1] 电话号码，若采用szEntryName 中定义的号码，置为NULL 值。

　　TCHAR szCallbackNumber[RAS_MaxCallbackNumber ＋1] 回拨号码，不用时置为NULL。

　　TCHAR szUserName[UNLEN ＋1] 用户标识。

　　TCHAR szPassword[PWLEN ＋1] 用户口令。

　　TCHAR szDomain[DNLEN ＋1] 用户权限验证域，若为NULL 采用RAS 服务器所在的域进行验证，若为‘＊’采用szEntryName 中定义的域进行验证。

　　RASCONNSTATE 枚举型结构，包含拨号连接过程中各种可能状态的定义。

　　函数RasHangUp() 用来终止拨号连接，因程序需要一定的时间来结束连接，应用程序调用该函数后不能马上退出，需等待3 秒后才能退出。

二、获取动态IP 地址API

　　在VC 中是通过调用函数RasGetProjectionInfo() 来获取IP 地址的。
　　函数调用成功时返回0 值，此时在RASPPPIP 结构变量中的szIpAddress 就是动态IP 地址。

三、程序实现

　　程序是在Win 95 环境下，用VC ＋＋5.0 编写，并编译运行通过。完整的源程序清单如下：
// －－－　－－－－－－－－－－－－－
//file name ras.c
// －－－　－－－－－－－－－－－－－
＃include < windows.h >
＃include < winuser.h >
＃include < string.h >
＃include < ras.h >
＃include < raserror.h >
＃include "resource.h"
// 函数原形
LRESULT CALLBACK DialogProc(HWND hDlg,
UINT message, WPARAM wParam, LPARAM lParam);
void ShowMsg(HWND hwnd,char ＊msg);
LRESULT MsgDialDlgEvent(HWND hdlg,
UINT uMessage, WPARAM wparam, LPARAM lparam);
VOID WINAPI RasDialFunc
( UINT unMsg, RASCONNSTATE rasconnstate,
　DWORD dwError );
BOOL StartCon( HWND hWnd,char
　　　　　＊szUser,char ＊szPassword );
UINT GetRasConnState( RASCONNSTATE rasconn );
// 全局变量
HRASCONN　　hCon; //RAS 连接句柄
HWND　　　　hWin;
HINSTANCE　 hInst;
// －－－　－－－－－－－－－－－－－－
//windows 入口函数
// －－－　－－－－－－－－－－－－－－
int PASCAL WinMain( HINSTANCE hInstance,
HINSTANCE hPrevInstance，LPSTR lpszCmdLine,
int nCmdShow )
{
　　　hInst=hInstance;
　　　if ( DialogBox(hInstance,"RAS_DLG",NULL,
　　 (DLGPROC)DialogProc) == －1 )
　　　MessageBox(NULL,"建立对话框失败！",
　　 "TITLE",MB_OK);
　　　return 0;
}
// －－－－－－－－－－－－－－－－－
// 对话框窗口函数
// －－－－－－－－－－－－－－－－－
LRESULT CALLBACK DialogProc(HWND hDlg,
UINT message, WPARAM wParam, LPARAM lParam)
{
switch (message)
{
　　case WM_INITDIALOG:
　　　hWin=hDlg;
　　　hCon=NULL;
　　　return (TRUE);
　　case WM_RASDIALEVENT:
　　　MsgDialDlgEvent(hDlg,message,wParam,lParam);
　　　return (TRUE);
　　case WM_COMMAND:
　　　switch (LOWORD(wParam))
　　　{
　　case IDOK:
　　　StartCon( hDlg,"ljx@public.smptt.fj.cn",
"abbcd");
　　　break;
　　case IDCANCEL:
　　　if ( hCon != NULL )
　　　{
　　　RasHangUp(hCon);
　　　Sleep(3000);
　　　}
　　　EndDialog(hDlg,TRUE);
　　　break;
　　　}
　　　break;
　　}
　　return (FALSE);
}
// ＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊
// 在列表框中显示信息
// ＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊
void ShowMsg(HWND hwnd,char ＊msg)
{
　　　int lnum;
　　SendDlgItemMessage(hwnd,IDC_MSG,
　　　LB_ADD ?STRING,0,(long)msg );
　lnum=SendDlgItemMessage(hwnd,IDC_MSG,
　　　LB_GETCOUNT, 0,0);
　　SendDlgItemMessage(hwnd,IDC_MSG,LB_SET ?
CURSEL,lnum －1,0);
　　return;
}
// －－－－－－－－－－－－－－－－－
// BOOL StartCon( HWND hWnd )
// 建立拨号连接, 成功TRUE else FALSE
// szUser 和szPassword 分别为
　Internet 的用户名和口令
// －－－－－－－－－－－－－－－－－
BOOL StartCon
( HWND hWnd,char ＊szUser,char ＊szPassword )
{
　　RASDIALPARAMS rdParams;
　　DWORD dwRet;
　　　char szBuf[300];
　　　// 初始化变量
　　rdParams.dwSize = sizeof(RASDIALPARAMS);
　　lstrcpy(rdParams.szEntryName, "internet");
　　rdParams.szPhoneNumber[0] = '\0';
　　rdParams.szCallbackNumber[0] = '＊';
　　rdParams.szCallbackNumber[0] = '\0';
　　strcpy(rdParams.szUserName,szUser);
　　strcpy(rdParams.szPassword,szPassword);
　　　rdParams.szDomain[0] = '\0';
　　　hCon=NULL;
　　　// 以下开始异步拨叫网络
　　dwRet = RasDial( NULL, NULL, ＆rdParams, 0L,
　　　　　　(RASDIALFUNC) RasDialFunc, ＆hCon );
　　if ( dwRet )
　　{
　　if ( RasGetErrorString( (UINT)dwRet,
　　　　 (LPSTR)szBuf, 256 ) != 0 )
　　wsprintf( (LPSTR)szBuf,
　　　“Undefined RAS Dial Error ( ％ld).", dwRet );
　　ShowMsg(hWnd,szBuf);
　　return FALSE;
　　}
　　　return TRUE;
}
// －－－－－－－－－－－－－－－
// RasDial 异步处理的回调函数
// unMsg　－发生的RAS 事件
// rasconnstate －连接进入的状态
// dwError　　　－发生的错误代码
// －－－－－－－－－－－－－－－
VOID WINAPI RasDialFunc
( UINT unMsg, RASCONNSTATE rasconnstate,
DWORD dwError )
{
　　PostMessage(hWin,
　　　　　　　WM_RASDIALEVENT,
　　　　　　　(WPARAM) rasconnstate,
　　　　　　　(LPARAM) dwError );
}
// －－－－－－－－－－－－－－－－
// RasDial() 返回的事件信息由该函数处理
// －－－－－－－－－－－－－－－－
LRESULT MsgDialDlgEvent(HWND hdlg, UINT uMessage,
WPARAM wparam, LPARAM lparam)
{
RASPPPIP rip;
DWORD ll,ret;
int num;
char szMessage[256];
LoadString(hInst,GetRasConnState
( (RASCONNSTATE) wparam ), szMessage, 64 );
ShowMsg(hdlg,szMessage);
if ( lparam )　// 发生错误
{
　　if ( RasGetErrorString
　　 ( (UINT)lparam, szMessage, 256 ) != 0 )
　　wsprintf( (LPSTR)szMessage,
　　　“出错Undefined RAS Dial Error." );
　　ShowMsg(hdlg,szMessage);
　　　　　　return TRUE;
　　　　　　　　　
　　}
　　else if ( RASCS_DONE ＆wparam ) // 连接成功
　　{
　　　// 取动态分配的IP 地址
　　　ShowMsg(hdlg,"连接成功");
　　　rip.dwSize=sizeof(RASPPPIP);
　　 if((ret=RasGetProjectionInfo(hCon,RASP_PppIp,
　　　(LPVOID) ＆rip,(LPDWORD) ＆ll )) != 0 )
　　　{
　　　ShowMsg(hdlg,"取IP 地址失败");
　　　}
　　　else
　　　ShowMsg(hdlg,rip.szIpAddress);
　　}
　　return TRUE;
}
// －－－－－－－－－－－－－－－－
// 根据连接状态
　取字符串资源中对应的标号
// －－－－－－－－－－－－－－－－
UINT GetRasConnState( RASCONNSTATE rasconn )
{
　　switch( rasconn )
　　{
　　　　case RASCS_OpenPort:
　　　　　　return IDS_OPENPORT;
　　　　case RASCS_PortOpened:
　　　　　　return IDS_PORTOPENED;
　　　　case RASCS_ConnectDevice:
　　　　　　return IDS_CONNECTDEVICE;
　　　　case RASCS_DeviceConnected:
　　　　　　return IDS_DEVICECONNECTED;
　　　　case RASCS_AllDevicesConnected:
　　　　　　return IDS_ALLDEVICESCONNECTED;
　　　　case RASCS_Authenticate:
　　　　　　return IDS_AUTHENTICATE;
　　　　case RASCS_AuthNotify:
　　　　　　return IDS_AUTHNOTIFY;
　　　　case RASCS_AuthRetry:
　　　　　　return IDS_AUTHRETRY;
　　　　case RASCS_AuthCallback:
　　　　　　return IDS_AUTHCALLBACK;
　　　　case RASCS_AuthChangePassword:
　　　　　　return IDS_AUTHCHANGEPASSWORD;
　　　　case RASCS_AuthProject:
　　　　　　return IDS_AUTHPROJECT;
　　　　case RASCS_AuthLinkSpeed:
　　　　　　return IDS_AUTHLINKSPEED;
　　　　case RASCS_AuthAck:
　　　　　　return IDS_AUTHACK;
　　　　case RASCS_ReAuthenticate:
　　　　　　return IDS_REAUTHENTICATE;
　　　　case RASCS_Authenticated:
　　　　　　return IDS_AUTHENTICATED;
　　　　case RASCS_PrepareForCallback:
　　　　　　return IDS_PREPAREFORCALLBACK;
　　　　case RASCS_WaitForModemReset:
　　　　　　return IDS_WAITFORMODEMRESET;
　　　　case RASCS_WaitForCallback:
　　　　　　return IDS_WAITFORCALLBACK;
　　　　case RASCS_Interactive:
　　　　　　return IDS_INTERACTIVE;
　　　　case RASCS_RetryAuthentication:
　　　　　　return IDS_RETRYAUTHENTICATION;
　　　　case RASCS_CallbackSetByCaller:
　　　　　　return IDS_CALLBACKSETBYCALLER;
　　　　case RASCS_PasswordExpired:
　　　　　　return IDS_PASSWORDEXPIRED;
　　　　case RASCS_Connected:
　　　　　　return IDS_CONNECTED;
　　　　case RASCS_Disconnected:
　　　　　　return IDS_DISCONNECTED;
　　　　default:
　　　　　　return IDS_UNDEFINED_ERROR;
　　}
} 　

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

华丽的分割线

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
序：近日，有位朋友问到用VC实现拨号上网的程序，今天在网上无意中发现了这篇文章，于是便转载过来，希望对这位朋友有所帮助！
正文：
大家知道，在netants、download expert等软件中都带有定时拨号上网下载软件的功能。而一般用户的拨号上网，利用的是windows的remote access service（ras，远程访问服务）。下面介绍一下其在visual c＋＋下的实现。
　　visual c＋＋为我们提供了包含ras api声明的“ras.h″头文件。要在程序中实现拨号上网功能，其大致过程如下：
　　1. 利用modem拨号进行连接，应使用rasdial函数。
　　其声明如下：
　　dword ras dial(lprasdialextensions lpras dialextensions,lpctstr lpszphonebook,lprasdialparams lp ras dialparams,dword dw notifier type,lpvoid lpv notifier, lphrasconn lph ras conn )
　　参数说明：
　　lprasdialextensions和lpszphonebook：仅在windows nt下有效，在windows 95下，这两个参数被忽略。
　　lprasdialparams：这个参数很重要，它指向一个rasdialparams结构，该结构包含以下几个成员：
　　dwsize：应设定为sizeof（rasdialparams）；
　　szentryname和szphonenumber：这两个参数有联系，szentryname可以指定要建立的连接，比方说“我的连接”等等，这是处理用户已经在“拨号网络”里建立的连接的。这时，modem将拨打你在“我的连接”中设定的isp号码，此时szphonenumber成员设为空字符串“”即可；如果你要在程序中自行指定要拨打的isp号码的话，szentryname可以设定为空字符串“”，此时应设置szphonenumber为你的isp号码（169，663等），特别的，对于用201电话卡来上网的情况，可以设为“201,,,账号，密码＃，，isp号码＃”（其中“，”表示停顿一段时间（以等待确认账号，密码等），你可以根据自己所在位置的线路状况自行调节。 szcallbacknumber，szdomain：设为空串“”即可。 szusername，szpassword：登录用户名和密码。如169公用账号guest，guest。
　　其他成员不必设置。
　　dwnotifiertype：指定是由窗口还是由回调函数来处理确认消息。通过确认消息我们可以得到rasdial过程的当前状态。如“正在打开段口”，“正在验证用户名和密码”等。也可设为null。 dwnotifier：指定处理确认消息的窗口或回调函数。也可设为null。
　　lphrasconn：指向一个类型为hrasconn的变量。在调用rasdial前必须指定为null，rasdial若成功返回，则将ras连接的句柄存放于它所指向的变量中。我们也可以通过此句柄来断开连接。
　　只要在程序中适当位置调用rasdial函数即可建立连接。
　　2. 理确认消息以得到拨号过程的当前状态。
　　我们以指定窗口来处理确认消息为例说明如何得到拨号过程的当前状态。
　　在处理确认消息的对话框类（或视图类等）的实现代码中加入：
　　const uint wm_rasevent = ::registerwindowmessagea(rasdialevent)；
　　在message map中手工加入消息映射：(＊＊＊＊是你定义的对话框类名称)
　　begin_message_map(＊＊＊＊, cdialog)
　　file://afx_msg_map(＊＊＊＊)
　　……
　　on_registered_message(wm_rasevent, onrasdialevent)（＜－加入此句）
　　file://afx_msg_map
　　end_message_map()
　　加入成员函数处理消息：
　　lresult cdialinfo::onrasdialevent(wparam wp, lparam lp)
　　{
　　rasconnstate rasstate= (rasconnstate)wp;
　　clistbox ＊info =(clistbox ＊)getdlgitem(idc_infolist);
　　file://用listbox 控件(id为idc－infolist)来显示状态)
　　switch(rasstate)
　　{
　　case rascs_openport:
　　info→addstring(_t(″打开端口……″));
　　break;
　　case rascs_portopened:
　　info→addstring(_t(″端口已打开.″));
　　break;
　　case rascs_connectdevice:
　　info→addstring(_t(″连接设备……″));
　　break;
　　case rascs_deviceconnected:
　　info→addstring(_t(″设备已连接.″));
　　break;
　　case rascs_authenticate:
　　info→addstring(_t(″验证用户及密码″));
　　break;
　　case rascs_authenticated:
　　info→addstring(_t(″通过″));
　　break;
　　case rascs_connected:
　　info－>addstring(_t(″已连接″));
　　reak;
　　case rascs_disconnected:
　　info－>addstring(_t(″连接已断开″));
　　m_hrasconn=null;
　　file://可定义类型为hrasconn的成员变量m_hrasconn来保存ras连接的句柄。
　　file://在调用rasdial时用指向m_hrasconn的指针作为lphrasconn参数。
　　file://既然用m_hrasconn来保存连接句柄，连接断开后应重置为null.
　　break;
　　default:
　　return (lresult)0;
　　}
　　return (lresult)0;
　　}
　　3. 断开连接：
　　if (m_hrasconn != null)
　　{
　　rashangup(m_hrasconn);
　　m_hrasconn = null;
　　m_ondial=true;
　　:sleep(2000);
　　}
　　注意：
　　你也许注意到了以上代码中的sleep函数，这里是必需的。需要一定时间来断开连接。如果不等待一段时间，计算机有可能无法正常关闭端口。导致下一次无法拨号，只有重新启动windows才能解决。要预防此问题也可以调用rasgetconnectstatus函数，方法如下：
　　rasconnstatus rstatus；
　　while（rasgetconnectstatus（m_hrasconn，＆rstatus）！=error_invalid_handle）

　　{
　　：：sleep（0）；
　　}
　　4．在以下情况下：
　　① 浏览网页时有时会出现停止响应，重启explorer后任务栏上的连接状态图标也许会消失。
　　② 希望在连接成功后，退出程序，再次执行此程序可选择断开连接。
　　可以调用rasenumconnection函数来得到当前连接的句柄。
　　举例如下：
　　hrasconn hrasconnect;dword dwbufffersize, dwnumofconnections;//缓冲区大小，连接数
　　lprasconn lprasconn;
　　lprasconn = new rasconn［3】;//最多可得到3个连接句柄，客户端程序其实不必设为3，因连接数有限，大部分仅一个连接。
　　lprasconn［0】.dwsize = sizeof(rasconn);
　　dwbufffersize = 32＊ sizeof(rasconn);//求出由3个rasconn结构构成的缓冲区大小
　　rasenumconnections(lpras conn, ＆dw buffer size, ＆dw numof connections)；//此函数若成功则返回零。
　　for(dword i=0; i 　　{
　　hrasconnect = lprasconn［i】.hrasconn;//rasconn结构的hrasconn成员为ras连接句柄
　　 rashangup(hrasconnect);
　　 ::sleep(2000);
　　}
　　delete ［】 lprasconn;
　　在windows 98，visual c＋＋ 6.0下调试通过。
　　这样，一个实现基本拨号上网功能的程序就完成了。如果你要了解更多有关情况或服务器端程序设计，可以参考msdn→platform sdk→networking and distributed services→remote access service的有关内容
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

华丽的分割线

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

背景：代替手工自动进行PPPOE拨号

Return Value

If the function succeeds, the return value is ERROR_SUCCESS and a handle to the RAS connection is returned in the variable pointed to by lphRasConn .

If the function fails, the return value is from Routing and Remote Access Error Codes or Winerror.h.

更多消息请查看：

http://msdn.microsoft.com/en-us/library/aa377004(VS.85).aspx

    RASDIALPARAMS ms;
    RASDIALPARAMS params;
    HRASCONN handle=NULL;

    memset(&ms, '/0', sizeof(params));
    params.dwSize=sizeof(RASDIALPARAMS);

    CString entryname;
    CString tmp;
    tmp.Format("%d", i);
    entryname="UE"+tmp;//需要拨号的名称，也就是建立的宽带连接的名称，如UE0
    strcpy(params.szEntryName,entryname);

    strcpy(params.szPhoneNumber,"");
    strcpy(params.szCallbackNumber,"");

    strcpy(params.szUserName,"tm500"); //用户名
    strcpy(params.szPassword, "tm500"); //密码
    strcpy(params.szDomain, "");

    Message +="/n"+entryname+"dailying up ......";
    UpdateData(TRUE);

   //指定的拨号连接。

    int a =RasDial(NULL, NULL, ¶ms, NULL, NULL, &handle);
    if (a!=ERROR_SUCCESS)
    {
        MessageBox("正在拨打的计算机没有应答，稍后请再试");

        Message +="/n"+entryname+"dailying up failed....../n";
        UpdateData(TRUE);

        DWORD off=RasHangUp(handle);

        //SendMessage(WM_CLOSE);
        if (off==0)
        {
        MessageBox("连接已断开");
        //printf("连接已断开.../n");
        }
        else{
        //printf("断开连接出错.../n");
          MessageBox("断开连接出错.");
        }
    }

C++ 拨号函数演示

/*********************************/ 
//code By PE_luck  
 
//百度:http://zhidao.baidu.com/question/73758972.html 
 
//2008-10-31  
 
/*********************************/  
 
#include  
#include  
#include  
#pragma comment(lib,"rasapi32.lib")  
 
int main(int argc,char *argv[]) 
{ 
printf("UserName:");  
char user[100]={0}; 
scanf("%s",user); 
printf("PassWord:"); 
char pass[100]={0}; 
scanf("%s",pass);  
 
//如果想自动请将上面的代码直接替换成你的用户名和密码  
 
    RASDIALPARAMSA rdParams; 
    rdParams.dwSize=sizeof(RASDIALPARAMSA); 
strcpy(rdParams.szEntryName,"宽带连接"); //连接名称是你的拨号名称 
rdParams.szPhoneNumber[0]='\0'; 
    rdParams.szCallbackNumber[0]='\0'; 
    strcpy(rdParams.szUserName,user); 
strcpy(rdParams.szPassword,pass); 
    rdParams.szDomain[0]='\0'; 
    HRASCONN hRscon=NULL; 
DWORD retn= RasDialA(NULL,NULL,&rdParams,0L,NULL,&hRscon);  
 
if (retn==0) 
{ 
   printf("已经连接上...\n"); 
   //断开函数 
   /* 
   DWORD off= RasHangUp(&hRscon); 
   if (off==0) 
   { 
   printf("连接已断开...\n"); 
   }else 
   printf("断开连接出错...\n"); 
   */ 
   //具体的细节慢慢扩充吧...仅仅演示一下... 
   return 0; 
} 
printf("连接出错...\n"); 
return 0;

聂文龙 2013-03-17 19:51 发表评论

VC实现HTTP协议的GET和POST方法

聂文龙 — Sat, 09 Jun 2012 13:55:00 GMT

以下是两个文件：HttpClient.h HttpClient.cpp 一个类
（错误检测部分没有加入）
使用方法
1：get方式
CHttpClient conn;
CString value="http://8crystal.com/test.asp";
value=conn.doGet(value);
2：post方式
CHttpClient conn;
CString value="http://8crystal.com/test.asp";
conn.addParam("name1","value1");
conn.addParam("name2","value2");
conn.addParam("name3","value3");
conn.addParam("name4","value4");
conn.addParam("name5","value5");
conn.addParam("name6","value6");
value=conn.doPost(value);

// HttpClient.h: interface for the CHttpClient class.
//
//////////////////////////////////////////////////////////////////////

#if !defined(AFX_HTTPCLIENT_H__EA769DCB_AAB9_47CD_BD87_FBD6913592C5__INCLUDED_)
#define AFX_HTTPCLIENT_H__EA769DCB_AAB9_47CD_BD87_FBD6913592C5__INCLUDED_

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000
#include "wininet.h"
#include "afxinet.h"
class CHttpClient
{
public:
void addParam(CString name,CString value);
CString doPost(CString href);
CString doGet(CString href);
CHttpClient();
virtual ~CHttpClient();

private:
CString CONTENT;
int CL;
CStringList values;
CStringList names;
};

#endif // !defined(AFX_HTTPCLIENT_H__EA769DCB_AAB9_47CD_BD87_FBD6913592C5__INCLUDED_)

++++++++++++++++++++++++++++++++++++++

// HttpClient.cpp: implementation of the CHttpClient class.
//
//////////////////////////////////////////////////////////////////////

#include "stdafx.h"
#include "emailsenderv2.h"
#include "HttpClient.h"

#ifdef _DEBUG
#undef THIS_FILE
static char THIS_FILE[]=__FILE__;
#define new DEBUG_NEW
#endif

//////////////////////////////////////////////////////////////////////
// Construction/Destruction
//////////////////////////////////////////////////////////////////////

CHttpClient::CHttpClient()
{

}

CHttpClient::~CHttpClient()
{

}

CString CHttpClient::doGet(CString href)
{
CString httpsource="";
CInternetSession session1(NULL,0);
CHttpFile* pHTTPFile=NULL;
try{
pHTTPFile=(CHttpFile*)session1.OpenURL(href);
//session1.
}catch(CInternetException){
pHTTPFile=NULL;
}
if(pHTTPFile)
{
CString text;
for(int i=0;pHTTPFile->ReadString(text);i++)
{
httpsource=httpsource+text+"\r\n";
}
pHTTPFile->Close();
delete pHTTPFile;
}else
{

}
return httpsource;
}

CString CHttpClient::doPost(CString href)
{
CString httpsource="";
CInternetSession session1;
CHttpConnection* conn1=NULL;
CHttpFile* pFile = NULL;
CString strServerName;
CString strObject;
INTERNET_PORT nPort;
DWORD dwServiceType;
AfxParseURL((LPCTSTR)href,dwServiceType, strServerName, strObject, nPort);
DWORD retcode;
char* outBuff = CONTENT.GetBuffer(1000);
try
{
conn1 = session1.GetHttpConnection(strServerName,nPort);
pFile = conn1->OpenRequest(0,strObject,NULL,1,NULL,"HTTP/1.1",INTERNET_FLAG_EXISTING_CONNECT|INTERNET_FLAG_NO_AUTO_REDIRECT);
pFile -> AddRequestHeaders("Content-Type: application/x-www-form-urlencoded");
pFile -> AddRequestHeaders("Accept: */*");
pFile -> SendRequest(NULL,0,outBuff,strlen(outBuff)+1);
pFile -> QueryInfoStatusCode(retcode);
}
catch (CInternetException * e){};
if(pFile)
{
CString text;
for(int i=0;pFile->ReadString(text);i++)
{
httpsource=httpsource+text+"\r\n";
}
pFile->Close();
}else
{

}
return httpsource;
delete pFile;
delete conn1;
session1.Close();
}

void CHttpClient::addParam(CString name, CString value)
{
names.AddTail((LPCTSTR)name);
values.AddTail((LPCTSTR)value);
CString eq="=";
CString an="&";
CONTENT=CONTENT+name+eq+value+an;
CL=CONTENT.GetLength();
}

聂文龙 2012-06-09 21:55 发表评论

DirectX与OpenGL方面的经典电子书下载

聂文龙 — Fri, 21 Nov 2008 03:11:00 GMT

Programming MS DirectShow for Digital Video & TV.chm
http://219.139.240.53/itebook/MS Press - Programming MS DirectShow for Digital Video & TV.chm

MICROSOFT.DIRECTX.9.PROGRAMMABLE.GRAPHICS.PIPELINE.rar
http://219.139.240.53/itebook/MS Press - MICROSOFT.DIRECTX.9.PROGRAMMABLE.GRAPHICS.PIPELINE.rar

Strategy.Game.Programming.with.DirectX.9.0.chm
http://219.139.240.53/itebook/1556229224-Strategy.Game.Programming.with.DirectX.9.0.chm

Strategy Game Programming with DirectX 9.0.ra
http://219.139.240.53/itebook/1556229224-Strategy Game Programming with DirectX 9.0.rar

Introduction to 3D Game Programming with DirectX 9.0.rar
http://219.139.240.53/itebook/1556229135-Introduction to 3D Game Programming with DirectX 9.0.rar

Programming Role-playing Games With DirectX
http://219.139.240.53/itebook/20040129174.rar

Real-time Rendering Tricks and Techniques in DirectX
http://219.139.240.53/itebook/20040129198.rar

Wordware.Publishing.Directx.9.User.Interfaces.Design.and.Implementation
http://219.139.240.53/itebook/20040829361.rar

MICROSOFT DIRECTX 9 PROGRAMMABLE GRAPHICS PIPELINE.rar
http://219.139.240.53/itebook/MS Press - MICROSOFT DIRECTX 9 PROGRAMMABLE GRAPHICS PIPELINE.rar

Wordware.Advanced.3D.Game.Programming.With.DirectX.9.0
http://219.139.240.53/itebook/20040829359.rar

Wordware.Advanced.3D.Game.Programming.With.DirectX.9.0
http://219.139.240.53/itebook/20040829356.rar

Advanced 3D Game Programming with DirectX 9.0.chm
http://219.139.240.53/itebook/Advanced 3D Game Programming with DirectX 9.0.chm

Premier.Press.Beginning.Direct3D.Game.Programming.2nd.Edition.chm
http://219.139.240.53/itebook/Premier.Press.Beginning.Direct3D.Game.Programming.2nd.Edition.chm

Sams.Managed.DirectX.9.Kick.Start.Graphics.And.Game.Programming.chm
http://219.139.240.53/itebook/Sams.Managed.DirectX.9.Kick.Start.Graphics.And.Game.Programming.chm

Wordware.Introduction.To.3D.Game.Programming.With.DirectX.9.0.chm
http://219.139.240.53/itebook/Wordware.Introduction.To.3D.Game.Programming.With.DirectX.9.0.chm

Wordware.Publishing.DirectX.9.Audio.Exposed.Interactive.Audio.Development.chm
http://219.139.240.53/itebook/Wordware.Publishing.DirectX.9.Audio.Exposed.Interactive.Audio.Development.chm

Wordware.Strategy.Game.Programming.With.DirectX.9.0.chm
http://219.139.240.53/itebook/Wordware.Strategy.Game.Programming.With.DirectX.9.0.chm

Wordware-DirectX 9 Audio Exposed Interactive Audio Development.rar
http://219.139.240.53/itebook/1556222882-Wordware-DirectX 9 Audio Exposed Interactive Audio Development.rar

Focus On 2D in Direct3D
http://219.139.240.53/itebook/20040827355.rar

OpenGL Programming Guide (Red Book).rar
http://219.139.240.53/itebook/0201461382-OpenGL Programming Guide (Red Book).rar

Using OpenGL in Visual C++
http://219.139.240.53/itebook/20040229088.rar

OpenGL Programming Guide.rar
http://219.139.240.53/itebook/Addison Wesley - OpenGL Programming Guide.rar

2_Advanced_Graphics_Programming_Techniques_Using_Opengl
http://219.139.240.53/itebook/20040827059.rar

聂文龙 2008-11-21 11:11 发表评论

Windows下架设Subversion服务器

聂文龙 — Tue, 28 Oct 2008 02:51:00 GMT

作者：indian

版本：v1.2

修订：2008年1月24日11:45:35

出处：blog.kysf.net

版权：作者保留对本文的一切修改、发布等权力。任何人想要转载本文部分或全部内容时，必须保留包括作者、版本、修订、出处、版权，共五项信息。对本文的参考引用，则不受限制。

关键词：subversion, 安装配置, 权限, 目录访问

1 前言
2 基本概念
　2.1 什么是版本控制
　2.2 什么是 Subversion
　2.3 版本库（repository）
3 安装配置
　3.1 安装独立服务器 SVNServer
　3.2 安装 ApacheSVN 服务器
4 FAQ
5 参考资料

1、前言

花了72小时，终于把 Subversion 初步掌握了。从一个连“什么是版本控制”都不知道的门外汉，到配置出精确至每目录访问的入门者，中间还卡了一天时间。其中费了许多气力，摸索实验了多次，还差点放弃了，但是收获是巨大的。现把我的配置和学习过程写下来，供大家参考，也让初学者少走弯路。

由于本人不会 Unix/Linux （正在学习中），故仅以 Windows 平台为例讲解，Unix/Linux 平台请参考相关资料。如其中有谬误的地方，包括错别字，请联系我修订。

技术在分享中进步！

2、基本概念

2.1、什么是版本控制

简单点来说，版本控制就是数据仓库，它可以记录你对文件的每次更改。这样，就算你在昏天黑地的改了几个月后老板说不要了，还是按照过去那样，你也不会抓狂，简单的恢复版本操作就搞定一切。

2.2、什么是 Subversion

Subversion是一个自由/开源版本控制系统，它管理文件和目录可以超越时间。一组文件存放在中心版本库，这个版本库很像一个普通的文件服务器，只是它可以记录每一次文件和目录的修改，这便使你可以取得数据以前的版本，从而可以检查所作的更改。从这个方面看，许多人把版本控制系统当作一种“时间机器”。

Subversion可以通过网络访问它的版本库，从而使用户可以在不同的电脑上使用。一定程度上可以说，允许用户在各自的地方修改同一份数据是促进协作。进展可能非常的迅速，并没有一个所有的改变都会取得效果的通道，由于所有的工作都有历史版本，你不必担心由于失去某个通道而影响质量，如果存在不正确的改变，只要取消改变。

一些版本控制系统也是软件配置管理（SCM）系统，这种系统经过特定的精巧设计来管理源代码，有许多关于软件开发的特性—本身理解编程语言、或者提供构建程序的工具。然而，Subversion不是这样一个系统，它是一个通用系统，可以管理任何类型的文件集，对你这可能是源代码，对别人，可能是一个货物报价单或者是书稿等。

2.3、版本库（repository）

Subversion 的核心就是 rpository ，中文翻译成“版本库”。就是位于服务器端，统一管理和储存数据的地方。

3、安装配置

3.1 安装独立服务器 SVNServer

环境

OS：Windows XP SP2

Web：Apache 2.2.6

SVN：svn-win32-1.4.6

一、准备工作

1、获取 Subversion 服务器程序

到官方网站（http://subversion.tigris.org/）下载最新的服务器安装程序。目前最新的是1.4.6版本，具体下载地址在：http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=8100&expandFolder=8100&folderID=91 ，注意找 for apache 2.2.x 版本的。

2、获取 TortoiseSVN 客户端程序

从官方网站 http://tortoisesvn.net/downloads 获取最新的 TortoiseSVN 。TortoiseSVN 是一个客户端程序，用来与 subvers 服务器端通讯。Subversion 自带一个客户端程序 svn.exe ,但 TortoiseSVN 更好操作，提高效率。

二、安装服务器端和客户端

首先安装 Apache 2.2.6 ，具体安装方法大家参考相关资料，或者参看我写的《Windows下安装Apache 2.2.x》。

其次安装 Subversion（以下简称SVN）的服务器端和客户端。下载下来的服务器端是个 zip 压缩包，直接解压缩即可，比如我解压到 E:\subversion 。客户端安装文件是个 exe 可执行文件，直接运行按提示安装即可，客户端安装完成后提示重启。

三、建立版本库（Repository）

运行Subversion服务器需要首先要建立一个版本库（Repository）。版本库可以看作是服务器上集中存放和管理数据的地方。

开始建立版本库。首先建立 e:\svn 空文件夹作为所有版本库的根目录。然后，进入命令行并切换到subversion的bin目录。输入如下命令：

svnadmin create E:\svn\repos1

此命令在 E:\svn 下建立一个版本库 repos1 。repos1 下面会自动生成一些文件夹和文件。

我们也可以使用 TortoiseSVN 图形化的完成这一步：

先建立空目录 E:\svn\repos1 ，注意一定是要空的。然后在 repos1 文件夹上“右键->TortoiseSVN->Create Repository here...”，然后可以选择版本库模式，这里使用默认的FSFS即可，然后就创建了一系列文件夹和文件，同命令行建立的一样。

四、运行独立服务器

此时 subversion 服务还没有开始，只是通过它的命令建立了版本库。继续在刚才的命令窗口输入：

svnserve.exe --daemon

svnserve 将会在端口 3690 等待请求，--daemon（两个短横线）选项告诉 svnserve 以守护进程方式运行，这样在手动终止之前不会退出。注意不要关闭命令行窗口，关闭窗口会把 svnserve 停止。

为了验证svnserve正常工作，使用TortoiseSVN -> Repo-browser 来查看版本库。在弹出的 URL 对话框中输入：

svn://localhost/svn/repos1

点 OK 按钮后就可以看见 repos1 版本库的目录树结构了，只不过这时 repos1 是个空库。

你也可以使用--root选项设置根位置来限制服务器的访问目录，从而增加安全性和节约输入svnserve URL的时间：

svnserve.exe --daemon --root drive:\path\to\repository

以前面的测试作为例，svnserve 将会运行为：

svnserve.exe --daemon --root e:\svn

然后TortoiseSVN中的版本库浏览器URL缩减为：

svn://localhost/repos1

五、配置用户和权限

用文本编辑器打开E:\svn\repos1\conf目录，修改svnserve.conf：

将：

# password-db = passwd

改为：

password-db = passwd

即去掉前面的 # 注释符，注意前面不能有空格。

然后修改同目录的passwd文件，增加一个帐号：

将：

[users]
# harry = harryssecret
# sally = sallyssecret

增加帐号：

[users]
#harry = harryssecret
#sally = sallyssecret
test = test

六、初始化导入

下面就是将我们的数据（项目）导入到这个版本库，以后就由版本库管理我们的数据。我们的任何改动都回被版本库记录下来，甚至我们自己丢失、改错数据时版本库也能帮我们找回数据。

比如，我在 d:\wwwroot 下有个 guestbook 文件夹，里面存放的是我编写的留言簿程序。在此文件夹上“右键 -> TortoiseSVN -> Import...” ，在弹出对话框的“URL of repository”输入“svn://localhost/repos1/guestbook”。在“Import message”输入“导入整个留言簿”作为注释。
点 OK 后要求输入帐号。我们在用户名和密码处都输入 test 。完成后 guestbook 中的内容全部导入到了 svn://localhost/svn/repos1/guestbook 。

我们看到在 e:\svn\repos1 没有任何变化，连个 guestbook 文件夹都没有建立，唯一的变化就是e:\svn\repos1容量变大了。实际上我们源guestbook中的内容已经导入 repos1 版本库了，源 guestbook 文件夹可以删除了。

需要注意的是，这一步操作可以完全在另一台安装了 TortoiseSVN 的客户机上进行。例如运行svnserve的主机的IP是133.96.121.22，则URL部分输入的内容就是“svn://133.96.121.22” 。

七、基本操作流程

1、取出（check out）

取出版本库到一个工作拷贝：

来到任意空目录下，比如在f分区建立一个空文件夹 f:\work 。“右键 -> SVN Checkout”。在“URL of repository”中输入“svn://localhost/svn/repos1/guestbook”，这样我们就得到了一份 guestbook 中内容的工作拷贝。

2、存入（check in）/提交（commit）

在工作拷贝中作出修改并提交：

在 guestbook 工作拷贝中随便打开一个文件，作出修改，然后“右键 -> SVN Commit... ”。这样我们就把修改提交到了版本库，版本库根据情况存储我们提交的数据。

在修改过的文件上“右键 -> TortoiseSVN -> Show Log” ，可以看到对这个文件所有的提交。在不同的 revision 条目上“右键 -> Compare with working copy”，我们可以比较工作拷贝的文件和所选 revision 版本的区别。

3.2 安装 ApacheSVN 服务器

Subversion的设计包括一个抽象的网络层，这意味着版本库可以通过各种服务器进程访问。理论上讲，Subversion可以使用无限数量的网络协议实现，目前实践中存在着两种服务器。

SVNServer：svnserve 是一个小的（也叫轻型的）、独立服务器，使用自己定义的协议和客户端。（作者注：以下称这种服务器为“svnserver服务器”，上面的安装配置就是安装svnserver服务器。）
ApacheSVN：Apache是最流行的web服务器，通过使用 mod_dav_svn 模块，Apache可以访问版本库，并且可以使客户端使用HTTP的扩展协议WebDAV/DeltaV进行访问。（作者注：以下称这种服务器为“ApacheSVN服务器”）

通过 Http 协议访问版本库是 Subversion 的亮点之一。ApacheSVN服务器 具备了许多 svnserve服务器 没有的特性，使用上更加灵活，但是有一点难于配置，灵活通常会带来复杂性。

由于 Subversion 需要版本化的控制，因此标准的 Http 协议不能满足需求。要让 Apache 与 Subversion 协同工作，需要使用 WebDAV（Web-based Distributed Authoring and Versioning：）Web 分布式创作和版本控制）。WebDAV 是 HTTP 1.1 的扩展，关于 WebDAV 的规范和工作原理，可以参考 IETF RFC 2518 。

一、必备条件

为了让你的版本库使用HTTP网络，你必需具备以下几个条件：

配置好httpd 2.2.x，并且使用mod_dav启动。
为mod_dav安装mod_dav_svn插件。
配置你的httpd.conf，使http协议能访问版本库。

下面以我的配置过程详细讲解。

环境：

OS：Windows XP SP2

Web：Apache 2.2.6

SVN：svn-win32-1.4.6

二、安装

1、安装Apache

具体安装方法见：《Windows下安装Apache 2.2.x》

2、安装 Subversion

将下载下来的 svn-win32-1.4.6.zip 直接解压即可，比如我解压到 e:\subversion 。
从Subversion安装目录的 bin 子目录将 intl3_svn.dll、libdb44.dll、mod_authz_svn.so、mod_dav_svn.so 拷贝到Apache的模块目录（Apache 安装目录的 modules 文件夹）。

三、基本的Apache配置

修改Apache的配置文件 httpd.conf ，使用LoadModule来加载mod_dav_svn模块。

将：

#LoadModule dav_module modules/mod_dav.so

改成：

LoadModule dav_module modules/mod_dav.so

即去掉前面的“#”号。

添加：

LoadModule dav_svn_module modules/mod_dav_svn.so

一定确定它在 mod_dav 之后。

现在你已经设置了Apache和Subversion，但是Apache不知道如何处理Subversion客户端，例如TortoiseSVN。为了让Apache知道哪个目录是用来作为Subversion版本库，你需要使用编辑器（例如记事本）编辑Apache的配置文件。

在配置文件最后添加如下几行：

DAV svn
SVNPath e:/svn/repos1

这个配置告诉Apache首先需要启用 dav_module，然后加载 dav_svn_module 。版本库对外的URL是：http://服务器IP/repository/ ，所有的Subversion版本库在物理上位于e:/svn/repos1/ 。

配置完毕后重新启动 Apache，打开浏览器，输入 http://服务器IP/ repository/ 将会看到如下画面：

这表示 Apache 的 dav_svn 模块已经可以正常工作了。用户可以使用任何一种 Subversion 的客户端通过 Http 协议访问你的版本库。

如果想要指定多个版本库，可以用多个 Location 标签，也可以使用 SVNParentPath 代替 SVNPath，例如在 e:\svn 下有多个版本库 repos1，repos2 等等，用如下方式指定：

　DAV svn
　SVNParentPath e:/svn

“SVNParentPath e:/svn ” 表示 e:\svn 下的每个子目录都是一个版本库。可以通过 http://服务器IP/repository/repos1/，http://服务器IP/repository/repos2/ 来访问。

现在你的版本库任何人都可以访问，并且有完全的写操作权限。也就是说任何人都可以匿名读取，修改，提交，以及删除版本库中的内容(注：这时不需要配置E:\svn\repos\conf\svnserve.conf 文件，并且也不需要启动E:\subversion\bin\svnserve.exe。因为提交是通过Apache的dav模块处理的，而不是由svnservice处理。)。我们用 TortoiseSVN 客户端验证即知。

显然大部分场合这是不符合需求的。那么如何进行权限设置呢，Apache 提供了基本的权限设置：

四、认证选项

1、基本 HTTP 认证

最简单的客户端认证方式是通过 HTTP 基本认证机制，简单的使用用户名和密码来验证一个用户的身份。Apache提供了一个 htpasswd 工具来管理一个用户文件，这个文件包含用户名和加密后的密码，这些就是你希望赋予 Subversion 特别权限的用户。htpasswd 可以在 Apache 的 bin 安装目录下找到。具体使用方法如下：

创建用户文件：
htpasswd -c E:\usr\Apache2.2\bin\passwd.conf username

添加新用户（-m 表示以 MD5 加密密码，可选项）：
htpasswd [-m] E:\usr\Apache2.2\bin\passwd.conf Newusername

更改用户密码：
htpasswd [-m] E:\usr\Apache2.2\bin\passwd.conf username

删除用户（要用大写的 D ）：
htpasswd –D E:\usr\Apache2.2\bin\passwd.conf username

接下来修改 httpd.conf，在 Location 标签中加入如下内容：

AuthType Basic
AuthName "svn repos"
AuthUserFile E:/usr/Apache2.2/bin/passwd.conf
Require valid-user

说明：

AuthType Basic：启用基本的验证，比如用户名/密码对。

AuthName "svn repos"：当一个认证对话框弹出时，出现在认证对话框中的信息。（最好用英文，TortoiseSVN 不支持中文，安装语言包除外。）

AuthUserFile E:/usr/Apache2.2/bin/passwd：指定E:\usr\Apache2.2\bin\passwd为用户文件，用来验证用户的用户名及密码。

Require valid-user：限定用户只有输入正确的用户名及密码后才能访问这个路径

重新启动 Apache ，打开浏览器访问版本库。Apache 会提示你输入用户名和密码来认证登陆了，现在只有 passwd 文件中设定的用户才可以访问版本库。也可以配置只有特定用户可以访问，替换上述 "Require valid-user" 为 "Require user tony robert" 将只有用户文件中的 tony 和 robert 可以访问该版本库。

有的时候也许不需要这样严格的访问控制，例如大多数开源项目允许匿名的读取操作，而只有认证用户才允许写操作。为了实现更为细致的权限认证，可以使用 Limit 和 LimitExcept 标签。例如：

require valid-user

以上配置将使匿名用户有读取权限，而限制只有 passwd 中配置的用户可以使用写操作。

如果这还不能满足你的要求，你希望精确的控制版本库目录访问，可以使用 Apache 的 mod_authz_svn 模块对每个目录进行认证操作。

2、用 mod_authz_svn 进行目录访问控制

首先需要让 Apache 将 mod_authz_svn 模块加载进来。在 Subversion 的安装目录中找到 mod_auth_svn 模块，将其拷贝到 Apache 安装目录的 modules 子目录下。修改 httpd.conf 文件，添加：

LoadModule authz_svn_module modules/mod_authz_svn.so

现在可以在 Location 标签中使用 authz 的功能了。一个基本的 authz 配置如下：

DAV svn
SVNParentPath e:/svn

# our access control policy
AuthzSVNAccessFile E:/usr/Apache2.2/bin/accesspolicy.conf

# try anonymous access first, resort to real
# authentication if necessary.
Satisfy Any
Require valid-user

# how to authenticate a user
AuthType Basic
AuthName "Subversion repository"
AuthUserFile E:/usr/Apache2.2/bin/passwd.conf

AuthzSVNAccessFile 指向的是 authz 的策略文件，详细的权限控制可以在这个策略文件中指定。访问文件 accesspolicy.conf 的语法与svnserve.conf和 Apache 的配置文件非常相似，以（#）开头的行会被忽略；在它的简单形式里，每一小节命名一个版本库和一个里面的路径；认证用户名是在每个小节中的选项名；每个选项的值描述了用户访问版本库的级别：r（只读）或者rw（读写），如果用户没有提到或者值留空，访问是不允许的； * 表示所有用户，用它控制匿名用户的访问权限；@符号区分组和用户。如：

[groups]
committers = paulex, richard
developers = jimmy, michel, spark, sean

[/]
* = r
@committers = rw

[/branches/dev]
@developers = rw

[/tags]
tony = rw
[/private]
* =
@committers= r

使用 SVNParentPath 代替 SVNPath 来指定多个版本库的父目录时，其中所有的版本库都将按照这个策略文件配置。例如上例中 tony 将对所有版本库里的 /tags 目录具有读写权限。如果要对具体每个版本库配置，用如下的语法：

[groups]
project1_committers = paulex, richard
project2_committers = jimmy, michel, spark, tony, Robert

[repos1:/]
* = r
@ project1_committer = rw

[repos2:/]
* = r
@ project2_committer = rw

这样项目1的 project1_committer 组只能对 repos1 版本库下的文件具有写权限而不能修改版本库 repos2 ，同样项目2的 project2_commiter 组也不能修改 repos1 版本库的文件。

4、FAQ

1、路径或权限不足时将出现错误信息提示：

http://localhost （路径不对）
Error * PROPFIND request failed on '/' PROPFIND of '/': 200 OK (http://localhost)

http://localhost/svn （权限不足）
Error * PROPFIND request failed on '/svn' PROPFIND of '/svn': 403 Forbidden (http://localhost)

http://localhost/svn/repos （正常显示）

http://localhost/repos （权限不允许）
Error * PROPFIND request failed on '/repos' PROPFIND of '/repos': 405 Method Not Allowed (http://localhost)

2、不启动E:\subversion\bin\svnserve.exe ，但启动了ApacheSVN ，访问（tortoiseSVN –> Repo – browser）或提交（SVN Commit）情形如下：

现象：svn://localhost/svn/repos 不能访问或提交，提示：Error * Can't connect to host 'localhost': 由于目标机器积极拒绝，无法连接。但 file:///e:/svn/repos 和 http://localhost/svn/repos 可以访问或提交。

原因：svn:// 是独立服务器 svnserver 自己的协议。file:/// 是本地访问，即服务器端和客户端在一个机器上。

参考资料：
Subversion 官方网站：Subversion 的官方网站，提供最权威的介绍和最新的下载。
Subversion 中文手册：Subversion 简体中文官方网站翻译的中文手册。
TortoiseSVN 中文文档：Subversion 简体中文官方网站翻译的 TortoiseSVN 中文文档。
我用SVN中文论坛：国内人气非常旺的 SVN 中文交流论坛。
《用Apache和Subversion搭建安全的版本控制环境》：IBM 工程师写的基于 Linux 的 SVN 教程。
百度百科：由全体网民共同撰写的百科全书

~ 全文完~

　　　　　　　　　　印第安

　　　　　　2007年12月23日23:37:41　v1.0 初稿
　　　　　　2007年12月25日2:24:53　v1.1 更新。更改了几处路径，使之更加便于Win下调试。全文重新排版，阅读条理更清晰。
　　　　　　2008年1月24日11:45:35　v1.2 修订。修改几处书写错误（谢谢山东济南的网易博友242）；修改1个关键配置路径。

聂文龙 2008-10-28 10:51 发表评论

svn版本控制

聂文龙 — Tue, 28 Oct 2008 02:49:00 GMT

文档规则
[本地工作区] ：work copy ，本地工作副本；
[主项目]：引用共用模块的新项目（工程）
最新版本（HEAD revision）：版本库里文件或目录的最新版本
SA ：SVN服务器的管理员
PRA ：单个项目库的管理员，或者是项目负责人
User ：普通工作人员
WC ：work copy ，本地工作副本

1. 版本控制原则
    SVN（或者其他版本控制软件）只是一个版本控制的辅助工具，不可能把所有的问题都自动解决掉。尤其，对于冲突这个麻烦事儿，项目成员在项目进程中要尽量通过优化流程来解决，而不是将希望寄托于软件工具来自动解决一切问题。
建议的开发过程组织：
  <1>. 随行就市>
项目刚开始阶段，单独开发；项目稳定阶段，完整开发。项目开发初期，各个项目成员负责自己的文件夹（或者模块），与SVN服务器间的更新、提交等操作只需要针对自己负责的文件夹（或者模块）就行了，他人的文件夹（或者模块）可以不必关心；项目稳定阶段，也就是每天的变更量很小了，所有项目成员与SVN服务器的更新、提交等操作需要针对项目的所有文件夹（或者模块），各个项目成员在其本地编译时本地工作区的全部项目程序（或者资料）均为最新的版本，保证项目作为整体能够顺利运行。
   <2>. 能躲就躲
尽量保证一份文件只有一个项目成员在编辑。举例说明：程序员A负责底层中文件 DBAccess.cs的编写，如果程序员B的工作要求他为DBAccess.cs增加两个方法，程序员B应该通知程序员A来增加而不是自己增加；如果此时A非常繁忙需要B自己增加，就需要B先更新本地的DBAccess.cs，然后开始修改，修改完成后立即提交并通知A更新本地的文件，通过缩短提交间隔来减少冲突。
2. 基于版本控制的开发流程

版本控制下的软件开发基本流程
注意：上述的流程中没有考虑测试和审核的步骤。
3.各阶段中svn的使用方法介绍
<1>.安装后的常规设置
  (1). 中文界面的设置
将TortoiseSVN的操作语言设置为中文，控制文件夹使用“_SVN”以便支持Asp.net项目。

  (2).忽略文件
  为防止在提交操作时将不必要的文件上传到SVN服务器上，可将项目中不需要受SVN控制的文件和文件夹通过设置忽略选项的方式排除掉。常被忽略的文件有 _* obj *.db *.resharper* *.Load *.pdb *.bak。可以根据实际需要来修改忽略参数，每个需要忽略的文件（文件夹）名称之间用空格作分隔符，需要忽略的文件夹只要写文件夹名称就行，例如 obj，忽略obj文件夹及所包含文件；_*忽略所有_（下划线）开头的文件夹及所包含文件。注意，这个设置仅对本机有效，而且对本机的所有项目的本地工作区有效，对其他项目组成员没有影响。被忽略的文件仍可以通过“添加”命令使其受SVN控制。

操作界面如下图，只需将忽略参数填写在“全局忽略模式”后的文本框中即可。

  (3).配置强制注释
  项目负责人通过设置项目的TortoiseSVN:logminisize设置为5，以便强制注释。设置方法：在项目的本地工作区文件夹上点击鼠标右键选择“属性”，进入 Subversion标签，选中TortoiseSVN: logminisize，确保复选框“递归应用该属性”选中，取值设为5，其意思是指提交的注释最短长度为五个字。注意，这个设置对其他项目成员的也有效，但是对别的SVN客户端工具（如AnkhSVN）无效。
<2>. 初始化版本库
初始化版本库有两种常用的方式：
  1. 直接“导入Import…”
对要执行导入操作得项目文件夹进行如下清理：
    (1). 把项目中不需要的文件删除。（临时文件、编译器创建的文件，比如*.obj、二进制文件等。）
    (2). 把文件夹和子文件夹中的所有文件整理一遍。虽然你可以在导入之后再来进行重命名或删除等操作，但是还是推荐你在导入之前把你的项目整理好。
在资源管理器（windows explorer）中选择项目(本地硬盘上)的根文件夹，单击鼠标右键，选择导入Import…命令，跳出一个对话框：

  在这个对话框中你需要填写你要将项目导入仓库的URL地址（svn必须小写）。导入信息（Important Message）是用来记录日志信息的。注意：与“忽略样式exclude pattern”匹配的文件或文件夹不会被导入，除非选择了“包含忽略的文件”选项。
按下“确定”按钮后，TortoiseSVN就开始把整个文件夹树（包括所有文件）导入到仓库。用来做“导入Import”操作的这个文件夹的名字不会出现在仓库中，只有文件夹中的内容会出现。注意：刚才用来做“导入Import”操作的这个文件夹并没有处于版本控制下！要获取一份处于版本控制之下的[本地工作区]副本，你需要对刚导入的版本做一次“检出Checkout”操作。
  2.“检出Checkout”—>“提交Commit”
新建一个空文件夹作为[本地工作区]的存放文件夹（建议与项目同名），在文件夹上（或者文件夹里）单击鼠标右键后在命令菜单中选择“检出Checkout…”，出现操作窗口。注意：只能检出Checkout到一个空文件夹。

  把本地硬盘上的项目文件夹中的内容（不要复制项目的根文件夹）全部复制到[本地工作区] 文件夹中，并对文件夹中进行清理操作（同“导入Import”操作前的清理操作）。然后选择[本地工作区] 文件夹单击鼠标右键跳出菜单，选择命令“提交Commit…”：

提交对话框会显示每一个有修改的文件，包括新增的，删除的，还有没有版本控制的。如果不想“提交Commit”某个有变更的文件，只需取消勾选那个文件即可。相反，如果要提交某个未受版本控制的文件，只需勾选它就可以然后“提交Commit”即可。
  3.日常开发中的SVN操作

0.版本号的解释
SVN系统中的版本号准确应该叫做“修订版本号”，每当版本库接受了一个提交Commit，文件系统进入了一个新的状态，叫做一次修订（revision），每一个修订版本被赋予一个独一无二的、递增的自然数，这个自然数就是修订版本号。
受控项目中任何一个受控文件/文件夹进行了修改提交Commit操作，项目的版本号就会提升一次，没有进行修改的文件/文件夹其版本号不会发生变化。受控项目每一个装态都包含项目的所有文件/文件夹，引起该次版本号增加的即修改了的文件/文件夹保存新副本，没有发生修改的文件/文件夹保存引用，因此项目中的文件/文件夹可能与项目的版本号不同。

0.更新(Update)工作副本

  把他人做的修改融合到自己的本地副本当中，这个把改动从服务器拿到本地的过程就是“更新Update”。“更新Update”操作可以针对一个文件，或几个被选择的文件，或某个文件夹中的所有文件。选择想要进行“更新Update”操作的文件和（或）文件夹，单击鼠标右键，在菜单中选择“更新 Update”，执行窗口显示正在“更新Update”的进度。他人做的修改会合并到自己的文件中，而自己所做的修改会被保留。如果不能合并，将会出现冲突（红色文字显示），冲突的文件图标将出现标志。
命令 “更新至版本Update to Revision...” 可以使[本地工作区]更新到自己选择的一个特定版本。

0.解决冲突
  选择的文件，点击鼠标右键菜单中选择“编辑冲突Edit Conflict”来打开合并工具或冲突编辑器，做一些必要的修改，然后保存文件。然后选择菜单中的“已解决的Resolved”命令执行，接着提交commit修改到仓库。
注意：命令“已解决的Resolved”并没有真正的解决冲突，它只不过是把“文件名称.扩展名.mine” 和 “文件名称.扩展名.r*”（r*中星号代表任意位数字，即版本号）删除，并允许你提交修改而已。因此，建议在有冲突发生时要先执行“编辑冲突Edit Conflict” 再执行“已解决的Resolved”；如果确信自己的修改是正确的，不需要保留他人的修改，可将文件名称.扩展名.mine去掉“.mine”后缀，并把 “.r*”后缀的文件和“”的文件删除，然后正常“提交Commit”，版本库中将保存自己的版本。

0.提交修改到仓库

  强烈建议在提交之前，应该确认[本地工作区] 是最新的。可以直接作一次“更新Update”操作，或者先“检查更新Check for Modifications”看看在本地或在服务器上哪些文件修改过。如果没有这样的操作直接提交的话，很有可能出现冲突现象。“检查更新Check for Modifications”操作后的结果界面如下：

  如果[本地工作区] 是最新的，并且没有冲突，就可以提交你的修改了。选中你想要提交的任意文件或文件夹，然后选择在菜单中选择“提交Commit…”在提交对话框中双击一个有修改的文件，可以启动外挂的比较工具来显示修改细节。在按下“确定OK”按钮之后，会显示提交的进程情况。

0.比较差异(Diff)

  [本地工作区] 修改后，被修改的文件出现标志，选择 “比较差异Diff” 命令，可以查看该文件与版本仓库中文件具体差异，选择命令后出现对应的差异察看窗口。

0.加入(Add)新文件/新文件夹

  想把在开发过程中创建的新文件/文件夹加入到SVN控制之下，可以这样做：选中文件/文件夹（在新文件/文件夹所在父文件夹点击右键），然后在菜单中选择“添加Add”命令。不需要受SVN控制的文件请取消钩选。

在把文件或文件夹加入到控制之下后，这些文件或文件夹就会显示为一个Added覆盖图标的样子，接下来必须对[本地工作区] 执行提交commit操作，以便其他团队成员能够看到这些文件或文件夹。

0.删除、重命名、移动
选择要删除（或重命名）的文件/文件夹，点击鼠标右键选择相应命令：

  如果使用TortoiseSVN的“删除Delete”操作删除了一个文件/文件夹，文件就已经从[本地工作区]中删除了，而被“删除Delete” 的文件夹将显示为覆盖图标。要恢复被“删除Delete”文件/文件夹，只需对他的上级文件夹进行“SVN还原revert”操作即可。
如果要在[本地工作区]内移动文件，可以使用鼠标来拖拽：
    1．选中要移动的文件或文件夹。
    2．用鼠标右键拖拽他们到[本地工作区]中一个新的文件夹。
    3．松开鼠标右键。
    4．在跳出的菜单中选择相应命令，如下图：

  如果一个删除操作不是使用TortoiseSVN的“删除Delete”操作完成的，而是就像平常删除文件那样删除的。提交时，对话框窗口还是会显示这些删除的文件，并提示自己把它们从版本控制下删除。所以如果忘记使用TortoiseSVN“删除Delete”操作来删除这些文件，仍可在这里补上。

0.取消改变(revert)
  如果要取消对一个文件/文件夹所做的修改，只需用鼠标右键单击该文件/文件夹，选择TortoiseSVN子菜单中的“SVN还原revert”命令，在操作窗口中会显示需要还原的文件/文件夹，勾选文件/文件夹后按下“确定OK”按钮即可。注意这里所做的取消修改只能返回到该文件/文件夹上次“更新Update”后的状态。

0.修订日志窗口
  每一次修改和提交，都应该做好日志记录。这样开发过程中就有了一个详细的记录，以后便可找出每一个修改是如何修改以及为什么这样修改的。日志对话框会显示所有日志信息。显示分成3个部分：
    1.最上面部分显示的是所有被提交的版本列表。显示有日期时间、提交者、修订版本号和日志信息的前面一部分。用蓝色显示的行表示有某些文件被复制到了这个版本。（也许是从一个分支来的）
    2.中间部分显示的是选中版本的所有日志信息。
    3.底部显示的是选中版本所做修改的文件和文件夹列表。
还不仅仅是这些，对话框中还提供了很多的菜单命令可以使用。

0.文件库浏览器
  选择“文件库浏览器”菜单，就可以打开Subversion服务器上版本库的结构，并可以对版本库中的文件/文件夹进行操作，如下图：

聂文龙 2008-10-28 10:49 发表评论

开始使用svn(subversion)

聂文龙 — Tue, 28 Oct 2008 02:41:00 GMT

windows下的客户端推荐使用TortoiseSVN。TortoiseSVN是windows平台下最经典的SVN客户端,操作及其简便直观,直接跟windows系统结合,通过文件/文件夹右键菜单方式进行管理您的项目.不过我喜欢用它的命令行，因为以前用CVS的时候就是用命令行，而SVN的命令行方式几乎和CVS是一样的，所以很快上手了。

从http://subversion.tigris.org获取subversion for windows的版本，安装之后就有了svn.exe这个基于命令行的客户端工具。当然服务器端的程序也有了，这里就不关心如何配置SVN服务了。安装程序把svn.exe的路径加入了path环境变量,我们已经可以在命令行中直接输入svn就可以使用了。

如果你不知道命令怎么用svn命令,可通过如下方式查询：
svn help
知道了子命令，但是不知道子命令的用法，还可以查询：
svn help ci

开发人员常用命令

导入项目
svn import http://svn.chinasvn.com:82/pthread --message "Start project"

导出项目
svn checkout http://svn.chinasvn.com:82/pthread

采用 export 的方式来导出一份“干净”的项目
svn export http://svn.chinasvn.com:82/pthread pthread

为失败的事务清场
svn cleanup

在本地进行代码修改，检查修改状态
svn status -v
svn diff

更新(update)服务器数据到本地
svn update directory
svn update file

增加(add)本地数据到服务器
svn add file.c
svn add dir

对文件进行改名和删除
svn mv b.c bb.c
svn rm d.c

提交(commit)本地文档到服务器
svn commit
svn ci
svn ci -m "commit"

查看日志
svn log directory
svn log file

相关的一些东西：
1、在本地文件中，每个目录下都有一个.svn文件夹(属性为隐藏)，保存了相关的信息。
2、注册环境变量SVN_EDITOR为"E:\Program Files\Vim\vim71\gvim.exe"，结果在svn ci的时候，出现错误:

'E:\Program' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
svn: 提交失败(细节如下):
svn: system('E:\Program Files\Vim\vim71\gvim.exe svn-commit.tmp') 返回 1

把SVN_EDITOR改为"gvim.exe"，并且在path中添加路径"E:\Program Files\Vim\vim71\",这样就可以在提交的时候用vim编写注释了。

附:
提供免费SVN服务的网站:
http://www.svnhost.cn/(推荐)
http://www.chinasvn.com
http://www.javaforge.com
http://unfuddle.com
http://svn.coollittlethings.com/index.php(针对开源免费，针对私人项目收费)

聂文龙 2008-10-28 10:41 发表评论

SVN-Subversion快速指南

聂文龙 — Tue, 28 Oct 2008 02:32:00 GMT

版权声明：转载时请以超链接形式标明文章原始出处和作者信息及本声明
 http://egeho123.blogbus.com/logs/18119163.html

Subversion快速指南

Subversion（简写为SVN）作为开源社区贡献的新一代版本控制系统，已经得到越来越广泛的使用。我用过CVS（Concurent Version System，SVN的前身）和微软的VSS（Visual SourceSafe），相比之下，SVN具有更强大的功能和更简单的操作特性。

网上已有一些文章介绍SVN的安装和使用，不过我在第一次配置时仍然遇到了几个问题。这里，我按照自己的思路来进行讲解，以期对那些初次使用SVN并且对一些问题存在疑问的朋友有所帮助。

1. SVN简介

光说SVN好，那SVN究竟有什么优点呢？在SVN的手册里有着详细的说明，下面简单介绍几个重要方面：

1) 基于目录的版本控制

传统的CVS或VSS都是基于单个文件进行版本控制的，这实际上满足不了实际需求，因为在实际应用中，我们都希望按照项目或者工程进行管理，例如假设我们想要取出某个历史时间点的整个项目文件，那么基于文件的版本控制系统就存在弊端，只能单个单个文件的处理。而SVN则能很方便的做到这一点，你可以随意的取出任何一个文件、任何一个目录的任何一个历史版本。

SVN还允许对文件和目录进行增加、删除以及复制和重命名等操作，这些都会被记录到历史信息中，实现真正的版本控制功能。

2) 原子提交

SVN里的每次操作都是原子的，要么全部成功，要么全部失败。假设你要提交多个文件，如果有一个存在冲突，那么其它修改都不会被提交。

3) 高效的分支（branching）与标签（tagging）功能

先说标签功能，通俗的讲，标签就是某个时间点的快照（snapshot），我们可以在项目进行到一些重要的里程碑之时为之建立标签，这样可以方便以后随时取出这些历史版本。我想你会有一个疑问：SVN不是本身就有随意取出任何一个历史版本的功能吗？是的，标签的作用主要是为了给这些特定的历史版本取一个友好的名字，以方便使用和维护。

分支则是用于创建多个并行的工作线，比如，当我们的一个项目需要为某个用户提供一些特殊的功能时，那么就可以为之创建一个分支，这样能够保正大部分代码的共用，也使得整个项目变得容易维护和管理。

SVN对于分支和标签的实现都是一样的，并且采用了与Unix/Linux硬链接（Hard-Link）类似的机制，即是说，当我们创建分支或标签时，SVN并不会立即为之创建一份拷贝，而是创建一个链接，只有当这些文件以后被修改时才会真正产生一份副本。这种“缓式拷贝”方法是一种常见的优化方法，能够有效的节约空间。

那分支和标签又有什么不同呢？不同之处仅仅在于其“约定成俗”的含义，标签意味着你不会再对其进行修改，而分支意味着你会对它进行开发。

4) 多种访问方式

SVN提供了一个抽象的网络访问层，可以通过不同的协议来对其进行访问。首先，SVN提供了自定义的svn协议访问方式，通过形如svn://host/repository的URL就能使用。再有，SVN还提供了与Apache Web服务器相集成的功能，这样，我们就可以通过http://host/repository的方式来访问SVN了。

5) 对二进制文件的支持

CVS虽然对二进制文件也有支持，但实现得并不完善，你或许遇到过文本文件里有中文字符而被认为是二进制文件的事情，SVN则提供了对二进制文件全面的支持，使得非文本文件也能跟文本文件一样进行良好的版本控制。

6) Windows下与资源管理器集成的客户端：TortoiseSVN

SVN本身只提供命令行的操作方式，TortoiseSVN是第三方开发的图形化界面，它的出现使Windows下的版本管理变得非常方便。不过，由于是嵌入到资源管理器中，它可能会影响系统的速度——微乎其微，你可以自己评测一下。

7) 平台无关

SVN秉承了开源软件的一贯优点，无论是Windows还是Linux平台，都可以相互访问SVN服务器。

如果你过去是VSS用户，那么这里还要提一点，与VSS相比，SVN还有一个理念不一样，VSS将版本冲突控制放在操作之前，你要操作某个项目必须先执行CheckOut以进行锁定、防止他人同时修改。SVN提供了同样的Lock功能，但通常情况下，我们只需各自独立的进行修改而无需锁定项目，如果有冲突在提交的时候再做处理，也就是说，SVN是将冲突控制放在操作之后、提交之时。也许你会觉得VSS更合理，但实际情况却相反，因为在我们的实际使用中经常发生有人将整个项目CheckOut后忘了CheckIn，或者未选择Recursive忘了将子目录中的文件CheckIn，这就让其他人无法修改，于是不得不人为的通知其本人，非常麻烦。

2. SVN服务器搭建

本节是针对管理员写的，普通用户可以跳过本节。我这里只以Windows上的安装为例，Linux上可按类似方式进行（有些配置参数会存在差别，具体参考帮助手册）。

1) 安装SVN服务器

a. 下载

SVN的官方网站为http://subversion.tigris.org/，当前最新版本为1.4.2。Windows下的二进制安装包分为两种，一种是以setup结尾的安装文件，另一种是普通的压缩包文件，setup文件会自动注册一些信息，比如环境变量以及服务等，这些都是可以自己手动实现的。在我写这篇文章时，官方网站上就只有普通二进制文件，估计setup文件稍晚些时候会出来。特别注意，下载时要详细阅读注意事项，看清与之配套的软件的版本号，避免出现问题。

我选择的版本为svn-win32-1.4.2.zip

b. 安装

将svn-win32-1.4.2.zip解压缩到安装目录下，我选择的是C:/Program Files/Subversion，如果是setup文件，直接运行安装文件即可。对于压缩包，我们可以将bin路径添加到系统环境变量中，以方便操作。可以看到，bin目录下主要有如下几个文件：

svnadmin：仓库管理工具，包括创建、修复和备份等操作。
svnlook：仓库查看工具，包括信息、日志和锁定状态等内容，不会造成仓库的改动。
svnserve：svn服务程序，允许通过svn网络协议来访问仓库。
svn：SVN客户端，用于访问仓库，对项目进行版本管理。
svnversion：客户端工具，用于查看本地拷贝的修订信息。
c. 创建仓库（Repository）

SVN是以仓库为版本控制单位的，一个SVN服务器可以管理多个仓库，每个仓库拥有独立的修订号（REVISION），仓库中的任何一次更新都会带来修订号的递增。你可以根据需要选择建立一个或者多个仓库，这里，我以创建多个仓库为例子，假设我们将仓库都放到D:/SVN_REPOS目录下，下面的命令将会在该目录下创建一个Test仓库：

svnadmin create D:/SVN_REPOS/Test
如果创建成功，D:/SVN_REPOS/下将会多一个Test目录。
2) 搭建svnserve访问方式

svn和http是两种并列的访问方式，你可以选择其中一种，也可以都采用。

a. 注册服务

为了让SVN服务程序每次开机后自动运行，我们需要将其注册为服务。在控制台中执行如下命令：

sc create svnservice binPath= "\"C:\Program Files\Subversion\bin\svnserve.exe\" --service -r D:/SVN_REPOS" start= auto
注意，上述命令均在一行中。sc.exe是Windows 2000以后系统自带的一个工具，2000下没有，可以从XP上拷过来。svnservice为服务名称，后面的参数格式有严格要求，等号前面没有空格而后面有。binPath本身带有多个参数，因此用引号括起来，而由于路径里面又有空格，因此又加上了一层引号。 --service和-r均为svnserve.exe的参数，前者要求它作为服务运行，后者指明了仓库的根路径（多仓库为仓库的父目录）。
带安装包的SVN会自动注册服务，这时我们可能需要修改-r参数，命令如下：

sc config svnservice binPath= "\"C:\Program Files\Subversion\bin\svnserve.exe\" --service -r D:/SVN_REPOS"
b. 访问

注册完后，通过运行sc start svnservice或者服务管理器（service.msc）启动服务。
接下来，我们就可以通过下面的命令来测试系统是否工作正常：

svn info svn://localhost/Test
如果正确的显示出仓库的相关信息，那么就大功告成了，否则请检查服务的参数是否配置正确，比如，如果未在服务参数中指定正确的-r值，就会得到如下错误：

No repository found in 'svn://localhost/Test'
如果安装了TortoiseSVN，则可以直接在浏览器中输入svn://localhost/Test，这样会调出TortoiseSVN的Repos-Browser。到此，你就可以通过TortoiseSVN来导入工程进行版本管理了（参见后文）。

c. 权限配置

在进行权限配置前，所有的用户都能进行任何操作，在很多情况下是不允许的。在创建仓库时，仓库目录下都会生成好几个文件夹，其中conf里面存储的是配置信息，包括三个文件：

authz：访问权限配置
passwd：用户名和密码配置
svnserve.conf：基本配置信息
先配置svnserve.conf，将里面几项配置前的注释去掉，最后的内容如下：

[general]
anon-access = read
auth-access = write
password-db = passwd
authz-db = authz
这些参数的含义文件里都有详细说明，其中，anon-access和auth-access分别是对匿名用户以及认证用户的访问控制，password-db指明用户密码文件路径，authz-db指明权限配置文件路径。另外还有一个参数realm用于指明仓库所属的认证域，默认情况下每个仓库位于不同的域（每个仓库有一个唯一的uuid），因此我们可以不设置该项，除非多个仓库需要共用同一份passwd配置。

passwd文件的配置很简单，格式如下（等号前面为用户名，后面为密码）：

[users]
harry = 123
sally = 123
guest = 123
authz则可以创建用户组并精确配置某个用户或用户组对某个文件或目录的访问权限，下面是一个例子：

[groups]
harry_and_sally = harry,sally

[/]
* = r

[/project1]
* =
harry = rw
sally = r

[/project1/foo]
sally =

[/project2]
@harry_and_sally = rw
guest = r

文件内容其实很简单易懂，groups用于定义用户组，后面便是对资源的具体访问控制，/表示仓库根目录，*表示所有用户，用户组前面需加上@符号，r表示可读，w表示可写，等号右边为空则表示没有权限。注意对于目录结构，当用户访问某个资源时，SVN会先看有没有直接针对该资源的访问控制，如果没有找到，则会继承上一级目录的访问权限，如此递推。

再提一点，当我们有多个仓库时，我们会发现这些仓库的用户帐号在大多数情况下都是相同的，因此，我们可以将passwd文件放到公共的地方，然后将所有仓库的password-db配置都指向该文件。相应的，authz-db也可以共用一个文件，不过需要在配置具体的访问控制时指明所属的仓库，如下：

[/]
* = r

[repos1:/project1]
* = r
harry = rw

[repos2:/project1]
* = r
sally = rw

上述配置表明，所有人对所有仓库的根目录都有读权限，但只有harry对仓库repos1里的project1有读写权限，只有sally对仓库repos2里的project1有读写权限。
3) 搭建HTTP访问方式

SVN可以通过Apache实现Web访问方式，但这不是必需的，除非你有此需求。

a) 下载

Apache的官方网站为http://www.apache.org/，注意不要使用最新的2.2.x，而要选择2.0.x，这一点在SVN官方网站上有特别说明，当初我就没有注意到这一点，而导致Apache2.2启动时无法加载SVN的模块，出现“perhaps this is not an Apache module DSO”错误。

我下载的版本为apache_2.0.59-win32-x86-no_ssl.msi

b) 安装和注册

执行Apache安装程序。由于2.0的版本不会自动注册为服务，因此我们需要手工处理。运行cmd.exe，进入apache安装目录下的bin文件夹，执行如下命令即可：

apache -k install
更多的命令可以通过apache help查看。

注册完后，就可以通过系统托盘里的Apache Monitor来启动服务。如果80端口未被占用，那么服务器应正常启动，通过http://127.0.0.1就能看到Apache的测试页面。

c) 配置

Apache是通过conf目录中的httpd.conf文件进行配置的，比如，默认的监听端口为80，在文件中搜索Listen 80，将80改成你所需的其它端口即可。配置完后必须重起Apache才能生效。更多关于Apache的配置说明请参见其帮助手册或google之。下面网站为帮助手册的中文版本。

为了让Apache支持SVN，比如增加一些配置项，一个典型的配置如下：

# 加载mod_dav模块，它是对WebDAV（Web-based Distributed Authoring and Versioning）协议的支持，由Apache自带
LoadModule dav_module modules/mod_dav.so

# 加载mod_dav_svn模块，它与mod_dav通信，使Apache支持SVN，它位于SVN的bin目录下。
LoadModule dav_svn_module "D:/Program Files/Subversion/bin/mod_dav_svn.so"

# 加载mod_authz_svn模块，用于进行权限管理
LoadModule authz_svn_module "D:/Program Files/Subversion/bin/mod_authz_svn.so"

# 配置SVN的访问路径以及相关相关参数
                             # 通过http://HOST/svn/访问SVN服务器
    DAV svn                                  # 必需
    SVNParentPath D:/SVN_REPOS               # 说明D:/SVN_REPOS下的所有目录均为仓库
    SVNListParentPath on                     # 在网页中列出D:/SVN_REPOS下的所有仓库

    AuthType Basic                           # 基本的用户名密码验证方式
    AuthName "SVN REPOS"                     # 认证名称，作提示用
    AuthUserFile D:/SVN_REPOS/users          # 用户名密码文件
    AuthzSVNAccessFile D:/SVN_REPOS/authz    # 权限控制文件

Require valid-user # 只有通过认证才能访问网页

# 重定向处理，用于将http://HOST/svn地址重定向为http://HOST/svn/
RedirectMatch ^(/svn)＄＄1/

下面对几个重要的地方作以说明：

i. 网上很多文章提到将mod_dav_svn.so和mod_authz_svn.so两个文件直接拷贝到Apache的modules目录下，当初我按照这种方法做时结果在一台Windows 2000 Server上无法启动Apache服务，为此折腾了半天。后来才明白，这些模块文件其实就是一些动态链接库，它需要依赖SVN的bin目录下的其它几个dll文件（可以把后缀改为dll，然后通过VC带的depends查看其依赖关系），因此如果没有设置环境变量，那么Apache加载这些模块时就会失败，当然也可以把所有依赖文件（主要是libdb43.dll ）拷贝过去。实际上，我们只需要通过绝对路径来引用这些模块即可，这样SVN升级后也不用再次拷贝。

ii. URL的访问路径为/svn/而不是/svn，因为后者可能有问题，导致通过http://HOST/svn访问出现如下错误信息

iii. SVNParentPath用于有多个仓库的情况，如果只有单个仓库，可以直接用SVNPath指明仓库路径。

iv. AuthUserFile指明用户名密码文件，但它与前面提到的SVN仓库下的passwd文件不是同一个文件，AuthUserFile是Apache的认证文件格式，二者的区别主要是用户名和密码的分割符不同，passwd是等号，这里的users是冒号，当初我就是把它们当成一个文件而造成客户端无法访问（为什么SVN不把passwd的格式定义成和AuthUserFile的一样呢？这样二者可以共用一个文件）。如果要对密码加密，那么users文件需通过Apache附带的htpasswd工具生成，实际上我们也可直接采用明文方式。

v. 权限控制文件AuthzSVNAccessFile与前面SVN里的authz一样，因此可以共用。

4) 其它管理功能

a. 备份

b. 修复

3. SVN客户端使用

本节针对客户端用户，主要介绍一些常用的操作方法。

1) 客户端安装

客户端可以采用命令行方式，也可以采用TortoiseSVN图形化方式，个人认为还是后者方便些。

TortoiseSVN从http://tortoisesvn.tigris.org/上获取，注意版本应与服务器保持一致。如果是命令行方式的话，那么从http://subversion.tigris.org/下载一个SVN二进制包就行了，此处不多讲。

TortoiseSVN属于图形化的客户端软件，其实前面的SVN安装包里已经含有客户端程序，只不过是命令行方式的，你可以根据需要选择是否安装。TortoiseSVN的官方网站为http://tortoisesvn.tigris.org/，同样，注意选择与SVN服务器配套的版本。

我这里使用的版本为TortoiseSVN-1.4.0.7501-win32-svn-1.4.0.msi

安装完后，会提示重起机器，实际上不用重起就能直接使用，只不过重起后会更新SVN文件图标的显示。下图是SVN工作区的右键菜单内容：

2) 主要操作

TortoiseSVN使用起来很简单，所有操作都通过右键菜单来完成。命令内容也很直观，而且有非常详细的帮助手册，这里只简单的介绍一下。

a) 导入项目（Import）

首先要把需要进行版本管理的工程（目录）整理好，去掉不必要的文件，比如编译器生成的临时文件。然后在最上层文件夹上单击右键，选择“TortoiseSVN -> Import...”，输入要存放的SVN服务器路径，确认即可。这样就将本地的项目导入到了服务器上。

命令行：svn import [PATH] URL

b) 检出项目（Checkout）

项目初次导入成功后，刚才本地的内容就没有用了，我们需要建立一个新的工作区，重新从SVN服务器下载受控的项目文件，执行“TortoiseSVN -> Checkout...”，选择或者输入项目的URL，确认即可，以后的工作都应在这个工作区里进行。

默认是获取项目的最新版本（HEAD），如果要获取历史版本，指定相应的修订号（Revision）即可。

命令行：svn checkout URL[@REV]... [PATH]

c) 更新与提交（Update and Commit）

他人修改了项目，我们需要从服务器下载最新版本，这通过“SVN Update”右键菜单实现。

命令行：svn update [PATH...]

如果是自己本地作了修改，则应及时将修改更新到服务器上去，这通过“SVN Commit...”实现。一个好的习惯是每次提交都应注明修改内容，以方便日后查证。

命令行：svn commit [PATH...]

d) 增加和删除文件（Add and Delete）

如果我们要向一个受控项目中添加新文件或文件夹，只需在目标上执行“TortoiseSVN -> Add”操作。注意，这里只是本地添加，要提交到服务器，还必须执行Commit才行。

命令行：svn add PATH...

同样，要删除受控文件或文件夹只需执行“TortoiseSVN -> Delete”操作。

命令行：svn delete PATH/URL...

TortoiseSVN还提供了一个重命名操作“TortoiseSVN -> Rename”，这其实是添加和删除的组合。

e) 撤销操作（Revert）

有时候，我们可能进行了错误的修改或者增加和删除，只要未进行提交，我们都可以通过“TortoiseSVN -> Revert”命令来撤销本地的所有更改。

命令行：svn revert PATH...

f) 查看信息

SVN提供了几种信息查看方式，其中Show log用于显示每次版本变更的日志信息，Repo-brower是仓库浏览器，类似于资源管理器，Revision graph则以图形化的方式让我们很直观的看到版本的变更情况，尤其是对于分支和标签管理很有帮助。

3) 其它操作

a) 冲突解决（Resolved）

如果我们本地进行了修改，而别人又把他的修改提交到了服务器上，这时我们执行Update就可能出现冲突（Conflict）。Resolved的作用不是解决冲突，它不进行任何合并，而是忽略掉他人的修改，允许我们将自己的版本提交到服务器上。

简单的说，Revent是撤销本地修改，而Resolved是保留本地修改。

b) 清除异常状态（Cleanup）

如果在执行某个命令的时候出现异常，比如服务器突然挂了，本地的工作区就会处于一种异常状态，通过Cleanup能够清除这种状态，使工作区不受到影响。

c) 锁定（Get lock）和解锁（Release lock）

冲突都是由于不同的开发人员同时修改了同一份文件造成的，因此，为了避免这种情况，我们可以强行锁定自己要修改的内容，这样其他人在我们解锁前就无法提交其修改。

d) 分支和标签（Branch/tag）

本文最开始就有说明，分支的目的是为了创建并行的工作线，标签的作用是为了保存项目某个版本的快照。二者在实现上却是一样的，都是通过Branch/tag命令执行。

e) 导出（Export）

为了实现版本管理，SVN会在工作区的每个目录下都生成一个隐藏的.svn文件夹，而我们有时却希望得到一个干净的没有.svn文件夹的项目结构，比如发布软件时，这种情况下就可以使用Export功能。

f) 重定向（Relocate）

有时候，SVN服务器的IP地址可能会发生变动，如果遇到这种情况，我们每个人的本地工作区都要重新下载吗？不用，只需通过Relocate重新配置一下本地工作区所对应的服务器地址就可以。

g) 补丁管理（patch）

不要被patch的名称迷惑，实际上它不属于SVN版本管理的范畴。这里所谓的patch是指那些对项目没有写权限（Commit）的人所作的修改，通过“TortoiseSVN -> Create Patch”生成，然后他们采用电子邮件等方式将patch发给项目管理员，由管理员执行“TortoiseSVN -> Apply Patch”并确认修改内容后再进行提交。该功能主要用于开源项目的管理。

聂文龙 2008-10-28 10:32 发表评论

VC++大杂烩

聂文龙 — Thu, 28 Aug 2008 08:48:00 GMT

摘要: 1. 如何获取系统日期 CTime tm = CTime :: GetCurrentTime(); CString strTime = tm.Format(_TEXT(“%Y-%M-%d %H:%M:%S)); MessageBox(strTime); 2. ... 阅读全文

聂文龙 2008-08-28 16:48 发表评论

Mysql日期和时间函数不求人

聂文龙 — Thu, 14 Aug 2008 16:28:00 GMT

对于每个类型拥有的值范围以及并且指定日期何时间值的有效格式的描述见7.3.6 日期和时间类型。

这里是一个使用日期函数的例子。下面的查询选择了所有记录，其date_col的值是在最后30天以内：

mysql> SELECT something FROM table
WHERE TO_DAYS(NOW()) - TO_DAYS(date_col) <= 30;

DAYOFWEEK(date)
返回日期date的星期索引(1=星期天，2=星期一, ……7=星期六)。这些索引值对应于ODBC标准。
mysql> select DAYOFWEEK('1998-02-03');
-> 3

WEEKDAY(date)
返回date的星期索引(0=星期一，1=星期二, ……6= 星期天)。
mysql> select WEEKDAY('1997-10-04 22:23:00');
-> 5
mysql> select WEEKDAY('1997-11-05');
-> 2

DAYOFMONTH(date)
返回date的月份中日期，在1到31范围内。
mysql> select DAYOFMONTH('1998-02-03');
-> 3

DAYOFYEAR(date)
返回date在一年中的日数, 在1到366范围内。
mysql> select DAYOFYEAR('1998-02-03');
-> 34

MONTH(date)
返回date的月份，范围1到12。
mysql> select MONTH('1998-02-03');
-> 2

DAYNAME(date)
返回date的星期名字。
mysql> select DAYNAME("1998-02-05");
-> 'Thursday'

MONTHNAME(date)
返回date的月份名字。
mysql> select MONTHNAME("1998-02-05");
-> 'February'

QUARTER(date)
返回date一年中的季度，范围1到4。
mysql> select QUARTER('98-04-01');
-> 2

WEEK(date)
　
WEEK(date,first)
对于星期天是一周的第一天的地方，有一个单个参数，返回date的周数，范围在0到52。2个参数形式WEEK()允许
你指定星期是否开始于星期天或星期一。如果第二个参数是0，星期从星期天开始，如果第二个参数是1，
从星期一开始。
mysql> select WEEK('1998-02-20');
-> 7
mysql> select WEEK('1998-02-20',0);
-> 7
mysql> select WEEK('1998-02-20',1);
-> 8

YEAR(date)
返回date的年份，范围在1000到9999。
mysql> select YEAR('98-02-03');
-> 1998

HOUR(time)
返回time的小时，范围是0到23。
mysql> select HOUR('10:05:03');
-> 10

MINUTE(time)
返回time的分钟，范围是0到59。
mysql> select MINUTE('98-02-03 10:05:03');
-> 5

SECOND(time)
回来time的秒数，范围是0到59。
mysql> select SECOND('10:05:03');
-> 3

PERIOD_ADD(P,N)
增加N个月到阶段P（以格式YYMM或YYYYMM)。以格式YYYYMM返回值。注意阶段参数P不是日期值。
mysql> select PERIOD_ADD(9801,2);
-> 199803

PERIOD_DIFF(P1,P2)
返回在时期P1和P2之间月数，P1和P2应该以格式YYMM或YYYYMM。注意，时期参数P1和P2不是日期值。
mysql> select PERIOD_DIFF(9802,199703);
-> 11

DATE_ADD(date,INTERVAL expr type)
　
DATE_SUB(date,INTERVAL expr type)
　
ADDDATE(date,INTERVAL expr type)
　
SUBDATE(date,INTERVAL expr type)
这些功能执行日期运算。对于MySQL 3.22，他们是新的。ADDDATE()和SUBDATE()是DATE_ADD()和DATE_SUB()的同义词。
在MySQL 3.23中，你可以使用+和-而不是DATE_ADD()和DATE_SUB()。（见例子）date是一个指定开始日期的
DATETIME或DATE值，expr是指定加到开始日期或从开始日期减去的间隔值一个表达式，expr是一个字符串；它可以以
一个“-”开始表示负间隔。type是一个关键词，指明表达式应该如何被解释。EXTRACT(type FROM date)函数从日期
中返回“type”间隔。下表显示了type和expr参数怎样被关联： type值含义期望的expr格式
SECOND 秒 SECONDS
MINUTE 分钟 MINUTES
HOUR 时间 HOURS
DAY 天 DAYS
MONTH 月 MONTHS
YEAR 年 YEARS
MINUTE_SECOND 分钟和秒 "MINUTES:SECONDS"
HOUR_MINUTE 小时和分钟 "HOURS:MINUTES"
DAY_HOUR 天和小时 "DAYS HOURS"
YEAR_MONTH 年和月 "YEARS-MONTHS"
HOUR_SECOND 小时, 分钟， "HOURS:MINUTES:SECONDS"
DAY_MINUTE 天, 小时, 分钟 "DAYS HOURS:MINUTES"
DAY_SECOND 天, 小时, 分钟, 秒 "DAYS HOURS:MINUTES:SECONDS"

MySQL在expr格式中允许任何标点分隔符。表示显示的是建议的分隔符。如果date参数是一个DATE值并且你的计算仅仅
包含YEAR、MONTH和DAY部分(即，没有时间部分)，结果是一个DATE值。否则结果是一个DATETIME值。

mysql> SELECT "1997-12-31 23:59:59" + INTERVAL 1 SECOND;
-> 1998-01-01 00:00:00
mysql> SELECT INTERVAL 1 DAY + "1997-12-31";
-> 1998-01-01
mysql> SELECT "1998-01-01" - INTERVAL 1 SECOND;
-> 1997-12-31 23:59:59
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
INTERVAL 1 SECOND);
-> 1998-01-01 00:00:00
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
INTERVAL 1 DAY);
-> 1998-01-01 23:59:59
mysql> SELECT DATE_ADD("1997-12-31 23:59:59",
INTERVAL "1:1" MINUTE_SECOND);
-> 1998-01-01 00:01:00
mysql> SELECT DATE_SUB("1998-01-01 00:00:00",
INTERVAL "1 1:1:1" DAY_SECOND);
-> 1997-12-30 22:58:59
mysql> SELECT DATE_ADD("1998-01-01 00:00:00",
INTERVAL "-1 10" DAY_HOUR);
-> 1997-12-30 14:00:00
mysql> SELECT DATE_SUB("1998-01-02", INTERVAL 31 DAY);
-> 1997-12-02
mysql> SELECT EXTRACT(YEAR FROM "1999-07-02");
-> 1999
mysql> SELECT EXTRACT(YEAR_MONTH FROM "1999-07-02 01:02:03");
-> 199907
mysql> SELECT EXTRACT(DAY_MINUTE FROM "1999-07-02 01:02:03");
-> 20102

如果你指定太短的间隔值(不包括type关键词期望的间隔部分)，MySQL假设你省掉了间隔值的最左面部分。例如，
如果你指定一个type是DAY_SECOND，值expr被希望有天、小时、分钟和秒部分。如果你象"1:10"这样指定值，
MySQL假设日子和小时部分是丢失的并且值代表分钟和秒。换句话说，"1:10" DAY_SECOND以它等价于"1:10" MINUTE_SECOND
的方式解释，这对那MySQL解释TIME值表示经过的时间而非作为一天的时间的方式有二义性。如果你使用确实不正确的日期，
结果是NULL。如果你增加MONTH、YEAR_MONTH或YEAR并且结果日期大于新月份的最大值天数，日子在新月用最大的天调整。

mysql> select DATE_ADD('1998-01-30', Interval 1 month);
-> 1998-02-28

注意，从前面的例子中词INTERVAL和type关键词不是区分大小写的。
TO_DAYS(date)
给出一个日期date，返回一个天数(从0年的天数)。
mysql> select TO_DAYS(950501);
-> 728779
mysql> select TO_DAYS('1997-10-07');
-> 729669

TO_DAYS()不打算用于使用格列高里历(1582)出现前的值。

FROM_DAYS(N)
给出一个天数N，返回一个DATE值。
mysql> select FROM_DAYS(729669);
-> '1997-10-07'

TO_DAYS()不打算用于使用格列高里历(1582)出现前的值。

DATE_FORMAT(date,format)
根据format字符串格式化date值。下列修饰符可以被用在format字符串中： %M 月名字(January……December)
%W 星期名字(Sunday……Saturday)
%D 有英语前缀的月份的日期(1st, 2nd, 3rd, 等等。）
%Y 年, 数字, 4 位
%y 年, 数字, 2 位
%a 缩写的星期名字(Sun……Sat)
%d 月份中的天数, 数字(00……31)
%e 月份中的天数, 数字(0……31)
%m 月, 数字(01……12)
%c 月, 数字(1……12)
%b 缩写的月份名字(Jan……Dec)
%j 一年中的天数(001……366)
%H 小时(00……23)
%k 小时(0……23)
%h 小时(01……12)
%I 小时(01……12)
%l 小时(1……12)
%i 分钟, 数字(00……59)
%r 时间,12 小时(hh:mm:ss [AP]M)
%T 时间,24 小时(hh:mm:ss)
%S 秒(00……59)
%s 秒(00……59)
%p AM或PM
%w 一个星期中的天数(0=Sunday ……6=Saturday ）
%U 星期(0……52), 这里星期天是星期的第一天
%u 星期(0……52), 这里星期一是星期的第一天
%% 一个文字“%”。

所有的其他字符不做解释被复制到结果中。

mysql> select DATE_FORMAT('1997-10-04 22:23:00', '%W %M %Y');
-> 'Saturday October 1997'
mysql> select DATE_FORMAT('1997-10-04 22:23:00', '%H:%i:%s');
-> '22:23:00'
mysql> select DATE_FORMAT('1997-10-04 22:23:00',
'%D %y %a %d %m %b %j');
-> '4th 97 Sat 04 10 Oct 277'
mysql> select DATE_FORMAT('1997-10-04 22:23:00',
'%H %k %I %r %T %S %w');
-> '22 22 10 10:23:00 PM 22:23:00 00 6'
MySQL3.23中，在格式修饰符字符前需要%。在MySQL更早的版本中，%是可选的。

TIME_FORMAT(time,format)
这象上面的DATE_FORMAT()函数一样使用，但是format字符串只能包含处理小时、分钟和秒的那些格式修饰符。
其他修饰符产生一个NULL值或0。
CURDATE()
　
CURRENT_DATE
以'YYYY-MM-DD'或YYYYMMDD格式返回今天日期值，取决于函数是在一个字符串还是数字上下文被使用。
mysql> select CURDATE();
-> '1997-12-15'
mysql> select CURDATE() + 0;
-> 19971215

CURTIME()
　
CURRENT_TIME
以'HH:MM:SS'或HHMMSS格式返回当前时间值，取决于函数是在一个字符串还是在数字的上下文被使用。
mysql> select CURTIME();
-> '23:50:26'
mysql> select CURTIME() + 0;
-> 235026

NOW()
　
SYSDATE()
　
CURRENT_TIMESTAMP
以'YYYY-MM-DD HH:MM:SS'或YYYYMMDDHHMMSS格式返回当前的日期和时间，取决于函数是在一个字符串还是在数字的
上下文被使用。
mysql> select NOW();
-> '1997-12-15 23:50:26'
mysql> select NOW() + 0;
-> 19971215235026

UNIX_TIMESTAMP()
　
UNIX_TIMESTAMP(date)
如果没有参数调用，返回一个Unix时间戳记(从'1970-01-01 00:00:00'GMT开始的秒数)。如果UNIX_TIMESTAMP()用一
个date参数被调用，它返回从'1970-01-01 00:00:00' GMT开始的秒数值。date可以是一个DATE字符串、一个DATETIME
字符串、一个TIMESTAMP或以YYMMDD或YYYYMMDD格式的本地时间的一个数字。
mysql> select UNIX_TIMESTAMP();
-> 882226357
mysql> select UNIX_TIMESTAMP('1997-10-04 22:23:00');
-> 875996580

当UNIX_TIMESTAMP被用于一个TIMESTAMP列，函数将直接接受值，没有隐含的“string-to-unix-timestamp”变换。

FROM_UNIXTIME(unix_timestamp)
以'YYYY-MM-DD HH:MM:SS'或YYYYMMDDHHMMSS格式返回unix_timestamp参数所表示的值，取决于函数是在一个字符串
还是或数字上下文中被使用。
mysql> select FROM_UNIXTIME(875996580);
-> '1997-10-04 22:23:00'
mysql> select FROM_UNIXTIME(875996580) + 0;
-> 19971004222300

FROM_UNIXTIME(unix_timestamp,format)
返回表示 Unix 时间标记的一个字符串，根据format字符串格式化。format可以包含与DATE_FORMAT()函数列出的条
目同样的修饰符。
mysql> select FROM_UNIXTIME(UNIX_TIMESTAMP(),
'%Y %D %M %h:%i:%s %x');
-> '1997 23rd December 03:43:30 x'

SEC_TO_TIME(seconds)
返回seconds参数，变换成小时、分钟和秒，值以'HH:MM:SS'或HHMMSS格式化，取决于函数是在一个字符串还是在数字
上下文中被使用。
mysql> select SEC_TO_TIME(2378);
-> '00:39:38'
mysql> select SEC_TO_TIME(2378) + 0;
-> 3938

TIME_TO_SEC(time)
返回time参数，转换成秒。
mysql> select TIME_TO_SEC('22:23:00');
-> 80580
mysql> select TIME_TO_SEC('00:39:38');
-> 2378

聂文龙 2008-08-15 00:28 发表评论

VC中Combo Box控件使用大全

聂文龙 — Fri, 08 Aug 2008 18:48:00 GMT

一、如何添加/删除Combo Box内容
1，在Combo Box控件属性的Data标签里面添加，一行表示Combo Box下拉列表中的一行。换行用ctrl+回车。
2，在程序初始化时动态添加
如： //控件内容初始化
CString strTemp;
((CComboBox*)GetDlgItem(IDC_COMBO_CF))->ResetContent();//消除现有所有内容
for(int i=1;i<=100;i++)
{
  strTemp.Format("%d",i);
  ((CComboBox*)GetDlgItem(IDC_COMBO_CF))->AddString(strTemp);
}
3，下拉的时候添加
如： CString strTemp;
int iCount=((CComboBox*)GetDlgItem(IDC_COMBO_CF))->GetCount();//取得目前已经有的行数
if(iCount<1)//防止重复多次添加
{
  ((CComboBox*)GetDlgItem(IDC_COMBO_CF))->ResetContent();
  for(int i=1;i<=100;i++)
  {
   strTemp.Format("%d",i);
   ((CComboBox*)GetDlgItem(IDC_COMBO_CF))->AddString(strTemp);
  }
}
4，删除
DeleteString( UINT nIndex )//删除指定行，
5，插入
InsertString( int nIndex, LPCTSTR lpszItem )//将行插入到指定位置
6，查找
FindString( int nStartAfter, LPCTSTR lpszItem )//可以在当前所有行中查找指定的字符传的位置，nStartAfter指明从那一行开始进行查找。
int SelectString( int nStartAfter, LPCTSTR lpszItem )//可以选中包含指定字符串的行
二、如何控制Combo Box的下拉长度

1，首先要知道两点：一、那就是在设计界面里，点击一下Combo Box的下拉箭头，此时出现的调整框就是Combo Box的下拉调整框。
2，二、属性里有个 No integral height 钩选项，表示最大长度为设计长度，如果实际内容比设计长度多，就出现滚动条，少就以实际长度显示。

三、选择其中的某行
1，选中：
int iPos=((CComboBox*)GetDlgItem(IDC_COMBO_CF))->GetCurSel();//当前选中的行。
2，设置
((CComboBox*)GetDlgItem(IDC_COMBO_CF))->SetCurSel(n)//设置第n行内容为显示的内容。

四、取得Combo Box框内容
1取当前内容
((CComboBox*)GetDlgItem(IDC_COMBO_CF))->GetWindowText(strTemp);

2取其他行内容
((CComboBox*)GetDlgItem(IDC_COMBO_CF))->GetLBText(n,strTemp);

聂文龙 2008-08-09 02:48 发表评论

Visual C++线程

聂文龙 — Thu, 27 Sep 2007 08:17:00 GMT

使线程同步

　　在程序中使用多线程时，一般很少有多个线程能在其生命期内进行完全独立的操作。更多的情况是一些线程进行某些处理操作，而其他的线程必须对其处理结果进行了解。正常情况下对这种处理结果的了解应当在其处理任务完成后进行。

　　如果不采取适当的措施，其他线程往往会在线程处理任务结束前就去访问处理结果，这就很有可能得到有关处理结果的错误了解。例如，多个线程同时访问同一个全局变量，如果都是读取操作，则不会出现问题。如果一个线程负责改变此变量的值，而其他线程负责同时读取变量内容，则不能保证读取到的数据是经过写线程修改后的。

　　为了确保读线程读取到的是经过修改的变量，就必须在向变量写入数据时禁止其他线程对其的任何访问，直至赋值过程结束后再解除对其他线程的访问限制。象这种保证线程能了解其他线程任务处理结束后的处理结果而采取的保护措施即为线程同步。

　　线程同步是一个非常大的话题，包括方方面面的内容。从大的方面讲，线程的同步可分用户模式的线程同步和内核对象的线程同步两大类。用户模式中线程的同步方法主要有原子访问和临界区等方法。其特点是同步速度特别快，适合于对线程运行速度有严格要求的场合。

　　内核对象的线程同步则主要由事件、等待定时器、信号量以及信号灯等内核对象构成。由于这种同步机制使用了内核对象，使用时必须将线程从用户模式切换到内核模式，而这种转换一般要耗费近千个CPU周期，因此同步速度较慢，但在适用性上却要远优于用户模式的线程同步方式。

　　临界区

　　临界区（Critical Section）是一段独占对某些共享资源访问的代码，在任意时刻只允许一个线程对共享资源进行访问。如果有多个线程试图同时访问临界区，那么在有一个线程进入后其他所有试图访问此临界区的线程将被挂起，并一直持续到进入临界区的线程离开。临界区在被释放后，其他线程可以继续抢占，并以此达到用原子方式操作共享资源的目的。

　　临界区在使用时以CRITICAL_SECTION结构对象保护共享资源，并分别用EnterCriticalSection（）和LeaveCriticalSection（）函数去标识和释放一个临界区。所用到的CRITICAL_SECTION结构对象必须经过InitializeCriticalSection（）的初始化后才能使用，而且必须确保所有线程中的任何试图访问此共享资源的代码都处在此临界区的保护之下。否则临界区将不会起到应有的作用，共享资源依然有被破坏的可能。

图1 使用临界区保持线程同步

　　下面通过一段代码展示了临界区在保护多线程访问的共享资源中的作用。通过两个线程来分别对全局变量g_cArray[10]进行写入操作，用临界区结构对象g_cs来保持线程的同步，并在开启线程前对其进行初始化。为了使实验效果更加明显，体现出临界区的作用，在线程函数对共享资源g_cArray[10]的写入时，以Sleep（）函数延迟1毫秒，使其他线程同其抢占CPU的可能性增大。如果不使用临界区对其进行保护，则共享资源数据将被破坏（参见图1（a）所示计算结果），而使用临界区对线程保持同步后则可以得到正确的结果（参见图1（b）所示计算结果）。代码实现清单附下：

// 临界区结构对象
CRITICAL_SECTION g_cs;
// 共享资源
char g_cArray[10];
UINT ThreadProc10(LPVOID pParam)
{
　// 进入临界区
　EnterCriticalSection(&g_cs);
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[i] = 'a';
　　Sleep(1);
　}
　// 离开临界区
　LeaveCriticalSection(&g_cs);
　return 0;
}
UINT ThreadProc11(LPVOID pParam)
{
　// 进入临界区
　EnterCriticalSection(&g_cs);
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[10 - i - 1] = 'b';
　　Sleep(1);
　}
　// 离开临界区
　LeaveCriticalSection(&g_cs);
　return 0;
}
……
void CSample08View::OnCriticalSection()
{
　// 初始化临界区
　InitializeCriticalSection(&g_cs);
　// 启动线程
　AfxBeginThread(ThreadProc10, NULL);
　AfxBeginThread(ThreadProc11, NULL);
　// 等待计算完毕
　Sleep(300);
　// 报告计算结果
　CString sResult = CString(g_cArray);
　AfxMessageBox(sResult);
}

　　在使用临界区时，一般不允许其运行时间过长，只要进入临界区的线程还没有离开，其他所有试图进入此临界区的线程都会被挂起而进入到等待状态，并会在一定程度上影响。程序的运行性能。尤其需要注意的是不要将等待用户输入或是其他一些外界干预的操作包含到临界区。如果进入了临界区却一直没有释放，同样也会引起其他线程的长时间等待。换句话说，在执行了EnterCriticalSection（）语句进入临界区后无论发生什么，必须确保与之匹配的LeaveCriticalSection（）都能够被执行到。可以通过添加结构化异常处理代码来确保LeaveCriticalSection（）语句的执行。虽然临界区同步速度很快，但却只能用来同步本进程内的线程，而不可用来同步多个进程中的线程。

　　MFC为临界区提供有一个CCriticalSection类，使用该类进行线程同步处理是非常简单的，只需在线程函数中用CCriticalSection类成员函数Lock（）和UnLock（）标定出被保护代码片段即可。对于上述代码，可通过CCriticalSection类将其改写如下：

// MFC临界区类对象
CCriticalSection g_clsCriticalSection;
// 共享资源
char g_cArray[10];
UINT ThreadProc20(LPVOID pParam)
{
　// 进入临界区
　g_clsCriticalSection.Lock();
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[i] = 'a';
　　Sleep(1);
　}
　// 离开临界区
　g_clsCriticalSection.Unlock();
　return 0;
}
UINT ThreadProc21(LPVOID pParam)
{
　// 进入临界区
　g_clsCriticalSection.Lock();
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[10 - i - 1] = 'b';
　　Sleep(1);
　}
　// 离开临界区
　g_clsCriticalSection.Unlock();
　return 0;
}
……
void CSample08View::OnCriticalSectionMfc()
{
　// 启动线程
　AfxBeginThread(ThreadProc20, NULL);
　AfxBeginThread(ThreadProc21, NULL);
　// 等待计算完毕
　Sleep(300);
　// 报告计算结果
　CString sResult = CString(g_cArray);
　AfxMessageBox(sResult);
}

　　管理事件内核对象

　　在前面讲述线程通信时曾使用过事件内核对象来进行线程间的通信，除此之外，事件内核对象也可以通过通知操作的方式来保持线程的同步。对于前面那段使用临界区保持线程同步的代码可用事件对象的线程同步方法改写如下：

// 事件句柄
HANDLE hEvent = NULL;
// 共享资源
char g_cArray[10];
……
UINT ThreadProc12(LPVOID pParam)
{
　// 等待事件置位
　WaitForSingleObject(hEvent, INFINITE);
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[i] = 'a';
　　Sleep(1);
　}
　// 处理完成后即将事件对象置位
　SetEvent(hEvent);
　return 0;
}
UINT ThreadProc13(LPVOID pParam)
{
　// 等待事件置位
　WaitForSingleObject(hEvent, INFINITE);
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[10 - i - 1] = 'b';
　　Sleep(1);
　}
　// 处理完成后即将事件对象置位
　SetEvent(hEvent);
　return 0;
}
……
void CSample08View::OnEvent()
{
　// 创建事件
　hEvent = CreateEvent(NULL, FALSE, FALSE, NULL);
　// 事件置位
　SetEvent(hEvent);
　// 启动线程
　AfxBeginThread(ThreadProc12, NULL);
　AfxBeginThread(ThreadProc13, NULL);
　// 等待计算完毕
　Sleep(300);
　// 报告计算结果
　CString sResult = CString(g_cArray);
　AfxMessageBox(sResult);
}

　　在创建线程前，首先创建一个可以自动复位的事件内核对象hEvent，而线程函数则通过WaitForSingleObject（）等待函数无限等待hEvent的置位，只有在事件置位时WaitForSingleObject（）才会返回，被保护的代码将得以执行。对于以自动复位方式创建的事件对象，在其置位后一被WaitForSingleObject（）等待到就会立即复位，也就是说在执行ThreadProc12（）中的受保护代码时，事件对象已经是复位状态的，这时即使有ThreadProc13（）对CPU的抢占，也会由于WaitForSingleObject（）没有hEvent的置位而不能继续执行，也就没有可能破坏受保护的共享资源。在ThreadProc12（）中的处理完成后可以通过SetEvent（）对hEvent的置位而允许ThreadProc13（）对共享资源g_cArray的处理。这里SetEvent（）所起的作用可以看作是对某项特定任务完成的通知。

　　使用临界区只能同步同一进程中的线程，而使用事件内核对象则可以对进程外的线程进行同步，其前提是得到对此事件对象的访问权。可以通过OpenEvent（）函数获取得到，其函数原型为：

HANDLE OpenEvent(
　DWORD dwDesiredAccess, // 访问标志
　BOOL bInheritHandle, // 继承标志
　LPCTSTR lpName // 指向事件对象名的指针
);

　　如果事件对象已创建（在创建事件时需要指定事件名），函数将返回指定事件的句柄。对于那些在创建事件时没有指定事件名的事件内核对象，可以通过使用内核对象的继承性或是调用DuplicateHandle（）函数来调用CreateEvent（）以获得对指定事件对象的访问权。在获取到访问权后所进行的同步操作与在同一个进程中所进行的线程同步操作是一样的。

　　如果需要在一个线程中等待多个事件，则用WaitForMultipleObjects（）来等待。WaitForMultipleObjects（）与WaitForSingleObject（）类似，同时监视位于句柄数组中的所有句柄。这些被监视对象的句柄享有平等的优先权，任何一个句柄都不可能比其他句柄具有更高的优先权。WaitForMultipleObjects（）的函数原型为：

DWORD WaitForMultipleObjects(
　DWORD nCount, // 等待句柄数
　CONST HANDLE *lpHandles, // 句柄数组首地址
　BOOL fWaitAll, // 等待标志
　DWORD dwMilliseconds // 等待时间间隔
);

　　参数nCount指定了要等待的内核对象的数目，存放这些内核对象的数组由lpHandles来指向。fWaitAll对指定的这nCount个内核对象的两种等待方式进行了指定，为TRUE时当所有对象都被通知时函数才会返回，为FALSE则只要其中任何一个得到通知就可以返回。dwMilliseconds在这里的作用与在WaitForSingleObject（）中的作用是完全一致的。如果等待超时，函数将返回WAIT_TIMEOUT。如果返回WAIT_OBJECT_0到WAIT_OBJECT_0+nCount-1中的某个值，则说明所有指定对象的状态均为已通知状态（当fWaitAll为TRUE时）或是用以减去WAIT_OBJECT_0而得到发生通知的对象的索引（当fWaitAll为FALSE时）。如果返回值在WAIT_ABANDONED_0与WAIT_ABANDONED_0+nCount-1之间，则表示所有指定对象的状态均为已通知，且其中至少有一个对象是被丢弃的互斥对象（当fWaitAll为TRUE时），或是用以减去WAIT_OBJECT_0表示一个等待正常结束的互斥对象的索引（当fWaitAll为FALSE时）。下面给出的代码主要展示了对WaitForMultipleObjects（）函数的使用。通过对两个事件内核对象的等待来控制线程任务的执行与中途退出：

// 存放事件句柄的数组
HANDLE hEvents[2];
UINT ThreadProc14(LPVOID pParam)
{
　// 等待开启事件
　DWORD dwRet1 = WaitForMultipleObjects(2, hEvents, FALSE, INFINITE);
　// 如果开启事件到达则线程开始执行任务
　if (dwRet1 == WAIT_OBJECT_0)
　{
　　AfxMessageBox("线程开始工作!");
　　while (true)
　　{
　　　for (int i = 0; i < 10000; i++);
　　　// 在任务处理过程中等待结束事件
　　　DWORD dwRet2 = WaitForMultipleObjects(2, hEvents, FALSE, 0);
　　　// 如果结束事件置位则立即终止任务的执行
　　　if (dwRet2 == WAIT_OBJECT_0 + 1)
　　　　break;
　　}
　}
　AfxMessageBox("线程退出!");
　return 0;
}
……
void CSample08View::OnStartEvent()
{
　// 创建线程
　for (int i = 0; i < 2; i++)
　　hEvents[i] = CreateEvent(NULL, FALSE, FALSE, NULL);
　　// 开启线程
　　AfxBeginThread(ThreadProc14, NULL);
　　// 设置事件0(开启事件)
　　SetEvent(hEvents[0]);
}
void CSample08View::OnEndevent()
{
　// 设置事件1(结束事件)
　SetEvent(hEvents[1]);
}

　　MFC为事件相关处理也提供了一个CEvent类，共包含有除构造函数外的4个成员函数PulseEvent（）、ResetEvent（）、SetEvent（）和UnLock（）。在功能上分别相当与Win32 API的PulseEvent（）、ResetEvent（）、SetEvent（）和CloseHandle（）等函数。而构造函数则履行了原CreateEvent（）函数创建事件对象的职责，其函数原型为：

CEvent(BOOL bInitiallyOwn = FALSE, BOOL bManualReset = FALSE, LPCTSTR lpszName = NULL, LPSECURITY_ATTRIBUTES lpsaAttribute = NULL );

　　按照此缺省设置将创建一个自动复位、初始状态为复位状态的没有名字的事件对象。封装后的CEvent类使用起来更加方便，图2即展示了CEvent类对A、B两线程的同步过程：

图2 CEvent类对线程的同步过程示意

　　B线程在执行到CEvent类成员函数Lock（）时将会发生阻塞，而A线程此时则可以在没有B线程干扰的情况下对共享资源进行处理，并在处理完成后通过成员函数SetEvent（）向B发出事件，使其被释放，得以对A先前已处理完毕的共享资源进行操作。可见，使用CEvent类对线程的同步方法与通过API函数进行线程同步的处理方法是基本一致的。前面的API处理代码可用CEvent类将其改写为：

// MFC事件类对象
CEvent g_clsEvent;
UINT ThreadProc22(LPVOID pParam)
{
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[i] = 'a';
　　Sleep(1);
　}
　// 事件置位
　g_clsEvent.SetEvent();
　return 0;
}
UINT ThreadProc23(LPVOID pParam)
{
　// 等待事件
　g_clsEvent.Lock();
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[10 - i - 1] = 'b';
　　Sleep(1);
　}
　return 0;
}
……
void CSample08View::OnEventMfc()
{
　// 启动线程
　AfxBeginThread(ThreadProc22, NULL);
　AfxBeginThread(ThreadProc23, NULL);
　// 等待计算完毕
　Sleep(300);
　// 报告计算结果
　CString sResult = CString(g_cArray);
　AfxMessageBox(sResult);
}

　　信号量内核对象

　　信号量（Semaphore）内核对象对线程的同步方式与前面几种方法不同，它允许多个线程在同一时刻访问同一资源，但是需要限制在同一时刻访问此资源的最大线程数目。在用CreateSemaphore（）创建信号量时即要同时指出允许的最大资源计数和当前可用资源计数。一般是将当前可用资源计数设置为最大资源计数，每增加一个线程对共享资源的访问，当前可用资源计数就会减1，只要当前可用资源计数是大于0的，就可以发出信号量信号。但是当前可用计数减小到0时则说明当前占用资源的线程数已经达到了所允许的最大数目，不能在允许其他线程的进入，此时的信号量信号将无法发出。线程在处理完共享资源后，应在离开的同时通过ReleaseSemaphore（）函数将当前可用资源计数加1。在任何时候当前可用资源计数决不可能大于最大资源计数。

图3 使用信号量对象控制资源

　　下面结合图例3来演示信号量对象对资源的控制。在图3中，以箭头和白色箭头表示共享资源所允许的最大资源计数和当前可用资源计数。初始如图（a）所示，最大资源计数和当前可用资源计数均为4，此后每增加一个对资源进行访问的线程（用黑色箭头表示）当前资源计数就会相应减1，图（b）即表示的在3个线程对共享资源进行访问时的状态。当进入线程数达到4个时，将如图（c）所示，此时已达到最大资源计数，而当前可用资源计数也已减到0，其他线程无法对共享资源进行访问。在当前占有资源的线程处理完毕而退出后，将会释放出空间，图（d）已有两个线程退出对资源的占有，当前可用计数为2，可以再允许2个线程进入到对资源的处理。可以看出，信号量是通过计数来对线程访问资源进行控制的，而实际上信号量确实也被称作Dijkstra计数器。

　　使用信号量内核对象进行线程同步主要会用到CreateSemaphore（）、OpenSemaphore（）、ReleaseSemaphore（）、WaitForSingleObject（）和WaitForMultipleObjects（）等函数。其中，CreateSemaphore（）用来创建一个信号量内核对象，其函数原型为：

HANDLE CreateSemaphore(
　LPSECURITY_ATTRIBUTES lpSemaphoreAttributes, // 安全属性指针
　LONG lInitialCount, // 初始计数
　LONG lMaximumCount, // 最大计数
　LPCTSTR lpName // 对象名指针
);

　　参数lMaximumCount是一个有符号32位值，定义了允许的最大资源计数，最大取值不能超过4294967295。lpName参数可以为创建的信号量定义一个名字，由于其创建的是一个内核对象，因此在其他进程中可以通过该名字而得到此信号量。OpenSemaphore（）函数即可用来根据信号量名打开在其他进程中创建的信号量，函数原型如下：

HANDLE OpenSemaphore(
　DWORD dwDesiredAccess, // 访问标志
　BOOL bInheritHandle, // 继承标志
　LPCTSTR lpName // 信号量名
);

　　在线程离开对共享资源的处理时，必须通过ReleaseSemaphore（）来增加当前可用资源计数。否则将会出现当前正在处理共享资源的实际线程数并没有达到要限制的数值，而其他线程却因为当前可用资源计数为0而仍无法进入的情况。ReleaseSemaphore（）的函数原型为：

BOOL ReleaseSemaphore(
　HANDLE hSemaphore, // 信号量句柄
　LONG lReleaseCount, // 计数递增数量
　LPLONG lpPreviousCount // 先前计数
);

　　该函数将lReleaseCount中的值添加给信号量的当前资源计数，一般将lReleaseCount设置为1，如果需要也可以设置其他的值。WaitForSingleObject（）和WaitForMultipleObjects（）主要用在试图进入共享资源的线程函数入口处，主要用来判断信号量的当前可用资源计数是否允许本线程的进入。只有在当前可用资源计数值大于0时，被监视的信号量内核对象才会得到通知。

　　信号量的使用特点使其更适用于对Socket（套接字）程序中线程的同步。例如，网络上的HTTP服务器要对同一时间内访问同一页面的用户数加以限制，这时可以为没一个用户对服务器的页面请求设置一个线程，而页面则是待保护的共享资源，通过使用信号量对线程的同步作用可以确保在任一时刻无论有多少用户对某一页面进行访问，只有不大于设定的最大用户数目的线程能够进行访问，而其他的访问企图则被挂起，只有在有用户退出对此页面的访问后才有可能进入。下面给出的示例代码即展示了类似的处理过程：

// 信号量对象句柄
HANDLE hSemaphore;
UINT ThreadProc15(LPVOID pParam)
{
　// 试图进入信号量关口
　WaitForSingleObject(hSemaphore, INFINITE);
　// 线程任务处理
　AfxMessageBox("线程一正在执行!");
　// 释放信号量计数
　ReleaseSemaphore(hSemaphore, 1, NULL);
　return 0;
}
UINT ThreadProc16(LPVOID pParam)
{
　// 试图进入信号量关口
　WaitForSingleObject(hSemaphore, INFINITE);
　// 线程任务处理
　AfxMessageBox("线程二正在执行!");
　// 释放信号量计数
　ReleaseSemaphore(hSemaphore, 1, NULL);
　return 0;
}
UINT ThreadProc17(LPVOID pParam)
{
　// 试图进入信号量关口
　WaitForSingleObject(hSemaphore, INFINITE);
　// 线程任务处理
　AfxMessageBox("线程三正在执行!");
　// 释放信号量计数
　ReleaseSemaphore(hSemaphore, 1, NULL);
　return 0;
}
……
void CSample08View::OnSemaphore()
{
　// 创建信号量对象
　hSemaphore = CreateSemaphore(NULL, 2, 2, NULL);
　// 开启线程
　AfxBeginThread(ThreadProc15, NULL);
　AfxBeginThread(ThreadProc16, NULL);
　AfxBeginThread(ThreadProc17, NULL);
}

图4 开始进入的两个线程

图5 线程二退出后线程三才得以进入

　　上述代码在开启线程前首先创建了一个初始计数和最大资源计数均为2的信号量对象hSemaphore。即在同一时刻只允许2个线程进入由hSemaphore保护的共享资源。随后开启的三个线程均试图访问此共享资源，在前两个线程试图访问共享资源时，由于hSemaphore的当前可用资源计数分别为2和1，此时的hSemaphore是可以得到通知的，也就是说位于线程入口处的WaitForSingleObject（）将立即返回，而在前两个线程进入到保护区域后，hSemaphore的当前资源计数减少到0，hSemaphore将不再得到通知，WaitForSingleObject（）将线程挂起。直到此前进入到保护区的线程退出后才能得以进入。图4和图5为上述代脉的运行结果。从实验结果可以看出，信号量始终保持了同一时刻不超过2个线程的进入。

　　在MFC中，通过CSemaphore类对信号量作了表述。该类只具有一个构造函数，可以构造一个信号量对象，并对初始资源计数、最大资源计数、对象名和安全属性等进行初始化，其原型如下：

CSemaphore( LONG lInitialCount = 1, LONG lMaxCount = 1, LPCTSTR pstrName = NULL, LPSECURITY_ATTRIBUTES lpsaAttributes = NULL );

　　在构造了CSemaphore类对象后，任何一个访问受保护共享资源的线程都必须通过CSemaphore从父类CSyncObject类继承得到的Lock（）和UnLock（）成员函数来访问或释放CSemaphore对象。与前面介绍的几种通过MFC类保持线程同步的方法类似，通过CSemaphore类也可以将前面的线程同步代码进行改写，这两种使用信号量的线程同步方法无论是在实现原理上还是从实现结果上都是完全一致的。下面给出经MFC改写后的信号量线程同步代码：

// MFC信号量类对象
CSemaphore g_clsSemaphore(2, 2);
UINT ThreadProc24(LPVOID pParam)
{
　// 试图进入信号量关口
　g_clsSemaphore.Lock();
　// 线程任务处理
　AfxMessageBox("线程一正在执行!");
　// 释放信号量计数
　g_clsSemaphore.Unlock();
　return 0;
}
UINT ThreadProc25(LPVOID pParam)
{
　// 试图进入信号量关口
　g_clsSemaphore.Lock();
　// 线程任务处理
　AfxMessageBox("线程二正在执行!");
　// 释放信号量计数
　g_clsSemaphore.Unlock();
　return 0;
}
UINT ThreadProc26(LPVOID pParam)
{
　// 试图进入信号量关口
　g_clsSemaphore.Lock();
　// 线程任务处理
　AfxMessageBox("线程三正在执行!");
　// 释放信号量计数
　g_clsSemaphore.Unlock();
　return 0;
}
……
void CSample08View::OnSemaphoreMfc()
{
　// 开启线程
　AfxBeginThread(ThreadProc24, NULL);
　AfxBeginThread(ThreadProc25, NULL);
　AfxBeginThread(ThreadProc26, NULL);
}

　　互斥内核对象

　　互斥（Mutex）是一种用途非常广泛的内核对象。能够保证多个线程对同一共享资源的互斥访问。同临界区有些类似，只有拥有互斥对象的线程才具有访问资源的权限，由于互斥对象只有一个，因此就决定了任何情况下此共享资源都不会同时被多个线程所访问。当前占据资源的线程在任务处理完后应将拥有的互斥对象交出，以便其他线程在获得后得以访问资源。与其他几种内核对象不同，互斥对象在操作系统中拥有特殊代码，并由操作系统来管理，操作系统甚至还允许其进行一些其他内核对象所不能进行的非常规操作。为便于理解，可参照图6给出的互斥内核对象的工作模型：

图6 使用互斥内核对象对共享资源的保护

　　图（a）中的箭头为要访问资源（矩形框）的线程，但只有第二个线程拥有互斥对象（黑点）并得以进入到共享资源，而其他线程则会被排斥在外（如图（b）所示）。当此线程处理完共享资源并准备离开此区域时将把其所拥有的互斥对象交出（如图（c）所示），其他任何一个试图访问此资源的线程都有机会得到此互斥对象。

　　以互斥内核对象来保持线程同步可能用到的函数主要有CreateMutex（）、OpenMutex（）、ReleaseMutex（）、WaitForSingleObject（）和WaitForMultipleObjects（）等。在使用互斥对象前，首先要通过CreateMutex（）或OpenMutex（）创建或打开一个互斥对象。CreateMutex（）函数原型为：

HANDLE CreateMutex(
　LPSECURITY_ATTRIBUTES lpMutexAttributes, // 安全属性指针
　BOOL bInitialOwner, // 初始拥有者
　LPCTSTR lpName // 互斥对象名
);

　　参数bInitialOwner主要用来控制互斥对象的初始状态。一般多将其设置为FALSE，以表明互斥对象在创建时并没有为任何线程所占有。如果在创建互斥对象时指定了对象名，那么可以在本进程其他地方或是在其他进程通过OpenMutex（）函数得到此互斥对象的句柄。OpenMutex（）函数原型为：

HANDLE OpenMutex(
　DWORD dwDesiredAccess, // 访问标志
　BOOL bInheritHandle, // 继承标志
　LPCTSTR lpName // 互斥对象名
);

　　当目前对资源具有访问权的线程不再需要访问此资源而要离开时，必须通过ReleaseMutex（）函数来释放其拥有的互斥对象，其函数原型为：

BOOL ReleaseMutex(HANDLE hMutex);

　　其唯一的参数hMutex为待释放的互斥对象句柄。至于WaitForSingleObject（）和WaitForMultipleObjects（）等待函数在互斥对象保持线程同步中所起的作用与在其他内核对象中的作用是基本一致的，也是等待互斥内核对象的通知。但是这里需要特别指出的是：在互斥对象通知引起调用等待函数返回时，等待函数的返回值不再是通常的WAIT_OBJECT_0（对于WaitForSingleObject（）函数）或是在WAIT_OBJECT_0到WAIT_OBJECT_0+nCount-1之间的一个值（对于WaitForMultipleObjects（）函数），而是将返回一个WAIT_ABANDONED_0（对于WaitForSingleObject（）函数）或是在WAIT_ABANDONED_0到WAIT_ABANDONED_0+nCount-1之间的一个值（对于WaitForMultipleObjects（）函数）。以此来表明线程正在等待的互斥对象由另外一个线程所拥有，而此线程却在使用完共享资源前就已经终止。除此之外，使用互斥对象的方法在等待线程的可调度性上同使用其他几种内核对象的方法也有所不同，其他内核对象在没有得到通知时，受调用等待函数的作用，线程将会挂起，同时失去可调度性，而使用互斥的方法却可以在等待的同时仍具有可调度性，这也正是互斥对象所能完成的非常规操作之一。

　　在编写程序时，互斥对象多用在对那些为多个线程所访问的内存块的保护上，可以确保任何线程在处理此内存块时都对其拥有可靠的独占访问权。下面给出的示例代码即通过互斥内核对象hMutex对共享内存快g_cArray[]进行线程的独占访问保护。下面给出实现代码清单：

// 互斥对象
HANDLE hMutex = NULL;
char g_cArray[10];
UINT ThreadProc18(LPVOID pParam)
{
　// 等待互斥对象通知
　WaitForSingleObject(hMutex, INFINITE);
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[i] = 'a';
　　Sleep(1);
　}
　// 释放互斥对象
　ReleaseMutex(hMutex);
　return 0;
}
UINT ThreadProc19(LPVOID pParam)
{
　// 等待互斥对象通知
　WaitForSingleObject(hMutex, INFINITE);
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[10 - i - 1] = 'b';
　　Sleep(1);
　}
　// 释放互斥对象
　ReleaseMutex(hMutex);
　return 0;
}
……
void CSample08View::OnMutex()
{
　// 创建互斥对象
　hMutex = CreateMutex(NULL, FALSE, NULL);
　// 启动线程
　AfxBeginThread(ThreadProc18, NULL);
　AfxBeginThread(ThreadProc19, NULL);
　// 等待计算完毕
　Sleep(300);
　// 报告计算结果
　CString sResult = CString(g_cArray);
　AfxMessageBox(sResult);
}

　　互斥对象在MFC中通过CMutex类进行表述。使用CMutex类的方法非常简单，在构造CMutex类对象的同时可以指明待查询的互斥对象的名字，在构造函数返回后即可访问此互斥变量。CMutex类也是只含有构造函数这唯一的成员函数，当完成对互斥对象保护资源的访问后，可通过调用从父类CSyncObject继承的UnLock（）函数完成对互斥对象的释放。CMutex类构造函数原型为：

CMutex( BOOL bInitiallyOwn = FALSE, LPCTSTR lpszName = NULL, LPSECURITY_ATTRIBUTES lpsaAttribute = NULL );

　　该类的适用范围和实现原理与API方式创建的互斥内核对象是完全类似的，但要简洁的多，下面给出就是对前面的示例代码经CMutex类改写后的程序实现清单：

// MFC互斥类对象
CMutex g_clsMutex(FALSE, NULL);
UINT ThreadProc27(LPVOID pParam)
{
　// 等待互斥对象通知
　g_clsMutex.Lock();
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[i] = 'a';
　　Sleep(1);
　}
　// 释放互斥对象
　g_clsMutex.Unlock();
　return 0;
}
UINT ThreadProc28(LPVOID pParam)
{
　// 等待互斥对象通知
　g_clsMutex.Lock();
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[10 - i - 1] = 'b';
　　Sleep(1);
　}
　// 释放互斥对象
　g_clsMutex.Unlock();
　return 0;
}
……
void CSample08View::OnMutexMfc()
{
　// 启动线程
　AfxBeginThread(ThreadProc27, NULL);
　AfxBeginThread(ThreadProc28, NULL);
　// 等待计算完毕
　Sleep(300);
　// 报告计算结果
　CString sResult = CString(g_cArray);
　AfxMessageBox(sResult);
}

　　小结

　　线程的使用使程序处理更够更加灵活，而这种灵活同样也会带来各种不确定性的可能。尤其是在多个线程对同一公共变量进行访问时。虽然未使用线程同步的程序代码在逻辑上或许没有什么问题，但为了确保程序的正确、可靠运行，必须在适当的场合采取线程同步措施。

聂文龙 2007-09-27 16:17 发表评论

如何让你的程序安全通过windows防火墙

聂文龙 — Mon, 24 Sep 2007 06:57:00 GMT

大家开发网络程序,经常要连接其他主机,如果在xp上运行,一定会提示你,只有选择解除阻止才能实现正常的网络连接.那么有没有办法在防火墙的例外列表里面通过编程的方式加入自己的程序呢?
当然有了,不然就不要介绍了
xp的系统目录下面有个hnetcfg.dll就是这个编程接口,头文件是netfw.h,初始化代码如下:
INetFwProfile* m_pFireWallProfile=NULL;

HRESULT hr = S_FALSE;
    INetFwMgr * fwMgr = NULL;
    INetFwPolicy * fwPolicy = NULL;

    FW_ERROR_CODE ret = FW_NOERROR;
     try
     {
         if ( m_pFireWallProfile )
             throw FW_ERR_INITIALIZED;

         // Create an instance of the firewall settings manager.
        hr = CoCreateInstance( __uuidof(NetFwMgr), NULL, CLSCTX_INPROC_SERVER, __uuidof( INetFwMgr), ( void ** ) & fwMgr );

         if ( FAILED( hr ))
             throw FW_ERR_CREATE_SETTING_MANAGER;

         // Retrieve the local firewall policy.
        hr = fwMgr -> get_LocalPolicy( & fwPolicy );
         if ( FAILED( hr ))
             throw FW_ERR_LOCAL_POLICY;

         // Retrieve the firewall profile currently in effect
        hr = fwPolicy -> get_CurrentProfile( & m_pFireWallProfile );
         if ( FAILED( hr ))
             throw FW_ERR_PROFILE;

    }
     catch ( FW_ERROR_CODE nError)
     {
        ret = nError;
    }

     if ( fwPolicy )
        fwPolicy -> Release();
     if ( fwMgr )
        fwMgr -> Release();

     return ret;

将程序名称加入例外列表:

WinXPSP2FireWall::AddApplication( const wchar_t* lpszProcessImageFileName, const wchar_t* lpszRegisterName )
{
    FW_ERROR_CODE ret = FW_NOERROR;
    HRESULT hr;
    BOOL bAppEnable;
    BSTR bstrProcessImageFileName = NULL;
    BSTR bstrRegisterName = NULL;
    INetFwAuthorizedApplication* pFWApp = NULL;
    INetFwAuthorizedApplications* pFWApps = NULL;

    try
    {
        if( m_pFireWallProfile == NULL )
            throw FW_ERR_INITIALIZED;
        if( lpszProcessImageFileName == NULL || lpszRegisterName  == NULL )
            throw FW_ERR_INVALID_ARG;

        // First of all, check the application is already authorized;
        FW_ERROR_CODE  nError = this->IsAppEnabled( lpszProcessImageFileName, bAppEnable );
        if( nError != FW_NOERROR )
            throw nError;

        // Only add the application if it isn't authorized
        if( bAppEnable == FALSE )
        {
            // Retrieve the authorized application collection
            hr = m_pFireWallProfile->get_AuthorizedApplications( &pFWApps );
            if( FAILED( hr ))
                throw FW_ERR_AUTH_APPLICATIONS;

            // Create an instance of an authorized application
            hr = CoCreateInstance( __uuidof(NetFwAuthorizedApplication), NULL, CLSCTX_INPROC_SERVER, __uuidof(INetFwAuthorizedApplication), (void**)&pFWApp);
            if( FAILED( hr ))
                throw FW_ERR_CREATE_APP_INSTANCE;

            // Allocate a BSTR for the Process Image FileName
            bstrProcessImageFileName = SysAllocString( lpszProcessImageFileName );
            if( SysStringLen( bstrProcessImageFileName ) == 0)
                throw FW_ERR_SYS_ALLOC_STRING;

            // Set the process image file name
            hr = pFWApp->put_ProcessImageFileName( bstrProcessImageFileName );
            if( FAILED( hr ) )
                throw FW_ERR_PUT_PROCESS_IMAGE_NAME;

            // Allocate a BSTR for register name
            bstrRegisterName = SysAllocString( lpszRegisterName );
            if( SysStringLen( bstrRegisterName ) == 0)
                throw FW_ERR_SYS_ALLOC_STRING;
            // Set a registered name of the process
            hr = pFWApp->put_Name( bstrRegisterName );
            if( FAILED( hr ))
                throw FW_ERR_PUT_REGISTER_NAME;

            // Add the application to the collection
            hr = pFWApps->Add( pFWApp );
            if( FAILED( hr ))
                throw FW_ERR_ADD_TO_COLLECTION;
        }
    }
    catch( FW_ERROR_CODE nError )
    {
        ret = nError;
    }

    SysFreeString( bstrProcessImageFileName );
    SysFreeString( bstrRegisterName );

    if( pFWApp )
        pFWApp->Release();
    if( pFWApps )
        pFWApps->Release();

    return ret;
}

聂文龙 2007-09-24 14:57 发表评论

Windows Socket API 使用小结

聂文龙 — Mon, 24 Sep 2007 06:54:00 GMT

一、WSAStartup函数
   int WSAStartup(
     WORD wVersionRequested,
     LPWSADATA lpWSAData
   );
   使用Socket的程序在使用Socket之前必须调用WSAStartup函数。该函数的第一个参数指明程序请求使用的Socket版本，其中高位字节指明副版本、低位字节指明主版本；操作系统利用第二个参数返回请求的Socket的版本信息。当一个应用程序调用WSAStartup函数时，操作系统根据请求的Socket版本来搜索相应的Socket库，然后绑定找到的Socket库到该应用程序中。以后应用程序就可以调用所请求的Socket库中的其它Socket函数了。该函数执行成功后返回0。
例：假如一个程序要使用2.1版本的Socket,那么程序代码如下
           wVersionRequested = MAKEWORD( 2, 1 );
           err = WSAStartup( wVersionRequested, &wsaData );

二、WSACleanup函数
   int WSACleanup (void);
   应用程序在完成对请求的Socket库的使用后，要调用WSACleanup函数来解除与Socket库的绑定并且释放Socket库所占用的系统资源。

三、socket函数
  SOCKET socket(
     int af,
     int type,
     int protocol
   );
   应用程序调用socket函数来创建一个能够进行网络通信的套接字。第一个参数指定应用程序使用的通信协议的协议族，对于TCP/IP协议族，该参数置PF_INET;第二个参数指定要创建的套接字类型，流套接字类型为SOCK_STREAM、数据报套接字类型为SOCK_DGRAM；第三个参数指定应用程序所使用的通信协议。该函数如果调用成功就返回新创建的套接字的描述符，如果失败就返回INVALID_SOCKET。套接字描述符是一个整数类型的值。每个进程的进程空间里都有一个套接字描述符表，该表中存放着套接字描述符和套接字数据结构的对应关系。该表中有一个字段存放新创建的套接字的描述符，另一个字段存放套接字数据结构的地址，因此根据套接字描述符就可以找到其对应的套接字数据结构。每个进程在自己的进程空间里都有一个套接字描述符表但是套接字数据结构都是在操作系统的内核缓冲里。下面是一个创建流套接字的例子：
       struct protoent *ppe;
       ppe=getprotobyname("tcp");
       SOCKET ListenSocket=socket(PF_INET,SOCK_STREAM,ppe->p_proto);

四、closesocket函数
  int closesocket(
     SOCKET s
   );
   closesocket函数用来关闭一个描述符为s套接字。由于每个进程中都有一个套接字描述符表，表中的每个套接字描述符都对应了一个位于操作系统缓冲区中的套接字数据结构，因此有可能有几个套接字描述符指向同一个套接字数据结构。套接字数据结构中专门有一个字段存放该结构的被引用次数，即有多少个套接字描述符指向该结构。当调用closesocket函数时，操作系统先检查套接字数据结构中的该字段的值，如果为1，就表明只有一个套接字描述符指向它，因此操作系统就先把s在套接字描述符表中对应的那条表项清除，并且释放s对应的套接字数据结构；如果该字段大于1，那么操作系统仅仅清除s在套接字描述符表中的对应表项，并且把s对应的套接字数据结构的引用次数减1。
closesocket函数如果执行成功就返回0，否则返回SOCKET_ERROR。

五、send函数
  int send(
     SOCKET s,
     const char FAR *buf,
     int len,
     int flags
   );
   不论是客户还是服务器应用程序都用send函数来向TCP连接的另一端发送数据。客户程序一般用send函数向服务器发送请求，而服务器则通常用send函数来向客户程序发送应答。该函数的第一个参数指定发送端套接字描述符；第二个参数指明一个存放应用程序要发送数据的缓冲区；第三个参数指明实际要发送的数据的字节数；第四个参数一般置0。这里只描述同步Socket的send函数的执行流程。当调用该函数时，send先比较待发送数据的长度len和套接字s的发送缓冲区的长度，如果len大于s的发送缓冲区的长度，该函数返回SOCKET_ERROR；如果len小于或者等于s的发送缓冲区的长度，那么send先检查协议是否正在发送s的发送缓冲中的数据，如果是就等待协议把数据发送完，如果协议还没有开始发送s的发送缓冲中的数据或者s的发送缓冲中没有数据，那么send就比较s的发送缓冲区的剩余空间和len，如果len大于剩余空间大小send就一直等待协议把s的发送缓冲中的数据发送完，如果len小于剩余空间大小send就仅仅把buf中的数据copy到剩余空间里（注意并不是send把s的发送缓冲中的数据传到连接的另一端的，而是协议传的，send仅仅是把buf中的数据copy到s的发送缓冲区的剩余空间里）。如果send函数copy数据成功，就返回实际copy的字节数，如果send在copy数据时出现错误，那么send就返回SOCKET_ERROR；如果send在等待协议传送数据时网络断开的话，那么send函数也返回SOCKET_ERROR。要注意send函数把buf中的数据成功copy到s的发送缓冲的剩余空间里后它就返回了，但是此时这些数据并不一定马上被传到连接的另一端。如果协议在后续的传送过程中出现网络错误的话，那么下一个Socket函数就会返回SOCKET_ERROR。（每一个除send外的Socket函数在执行的最开始总要先等待套接字的发送缓冲中的数据被协议传送完毕才能继续，如果在等待时出现网络错误，那么该Socket函数就返回SOCKET_ERROR）
注意：在Unix系统下，如果send在等待协议传送数据时网络断开的话，调用send的进程会接收到一个SIGPIPE信号，进程对该信号的默认处理是进程终止。

六、recv函数
   int recv(
     SOCKET s,
     char FAR *buf,
     int len,
     int flags
   );
   不论是客户还是服务器应用程序都用recv函数从TCP连接的另一端接收数据。该函数的第一个参数指定接收端套接字描述符；第二个参数指明一个缓冲区，该缓冲区用来存放recv函数接收到的数据；第三个参数指明buf的长度；第四个参数一般置0。这里只描述同步Socket的recv函数的执行流程。当应用程序调用recv函数时，recv先等待s的发送缓冲中的数据被协议传送完毕，如果协议在传送s的发送缓冲中的数据时出现网络错误，那么recv函数返回SOCKET_ERROR，如果s的发送缓冲中没有数据或者数据被协议成功发送完毕后，recv先检查套接字s的接收缓冲区，如果s接收缓冲区中没有数据或者协议正在接收数据，那么recv就一直等待，只到协议把数据接收完毕。当协议把数据接收完毕，recv函数就把s的接收缓冲中的数据copy到buf中（注意协议接收到的数据可能大于buf的长度，所以在这种情况下要调用几次recv函数才能把s的接收缓冲中的数据copy完。recv函数仅仅是copy数据，真正的接收数据是协议来完成的），recv函数返回其实际copy的字节数。如果recv在copy时出错，那么它返回SOCKET_ERROR；如果recv函数在等待协议接收数据时网络中断了，那么它返回0。
注意：在Unix系统下，如果recv函数在等待协议接收数据时网络断开了，那么调用recv的进程会接收到一个SIGPIPE信号，进程对该信号的默认处理是进程终止。

七、bind函数
  int bind(
     SOCKET s,
     const struct sockaddr FAR *name,
     int namelen
   );
   当创建了一个Socket以后，套接字数据结构中有一个默认的IP地址和默认的端口号。一个服务程序必须调用bind函数来给其绑定一个IP地址和一个特定的端口号。客户程序一般不必调用bind函数来为其Socket绑定IP地址和断口号。该函数的第一个参数指定待绑定的Socket描述符；第二个参数指定一个sockaddr结构，该结构是这样定义的：
struct sockaddr {
           u_short sa_family;
           char sa_data[14];
       };
  sa_family指定地址族，对于TCP/IP协议族的套接字，给其置AF_INET。当对TCP/IP协议族的套接字进行绑定时，我们通常使用另一个地址结构：
       struct sockaddr_in {
           short   sin_family;
           u_short sin_port;
           struct  in_addr sin_addr;
           char    sin_zero[8];
       };
   其中sin_family置AF_INET；sin_port指明端口号；sin_addr结构体中只有一个唯一的字段s_addr，表示IP地址，该字段是一个整数，一般用函数inet_addr（）把字符串形式的IP地址转换成unsigned long型的整数值后再置给s_addr。有的服务器是多宿主机，至少有两个网卡，那么运行在这样的服务器上的服务程序在为其Socket绑定IP地址时可以把htonl(INADDR_ANY)置给s_addr，这样做的好处是不论哪个网段上的客户程序都能与该服务程序通信；如果只给运行在多宿主机上的服务程序的Socket绑定一个固定的IP地址，那么就只有与该IP地址处于同一个网段上的客户程序才能与该服务程序通信。我们用0来填充sin_zero数组，目的是让sockaddr_in结构的大小与sockaddr结构的大小一致。下面是一个bind函数调用的例子：
   struct sockaddr_in saddr；
   saddr.sin_family = AF_INET;
   saddr.sin_port = htons(8888);
   saddr.sin_addr.s_addr = htonl(INADDR_ANY);
   bind(ListenSocket,(struct sockaddr *)&saddr,sizeof(saddr))；

八、listen函数
   int listen( SOCKET s, int backlog );
   服务程序可以调用listen函数使其流套接字s处于监听状态。处于监听状态的流套接字s将维护一个客户连接请求队列，该队列最多容纳backlog个客户连接请求。假如该函数执行成功，则返回0；如果执行失败，则返回SOCKET_ERROR。

九、accept函数
   SOCKET accept(
     SOCKET s,
     struct sockaddr FAR *addr,
     int FAR *addrlen
   );
   服务程序调用accept函数从处于监听状态的流套接字s的客户连接请求队列中取出排在最前的一个客户请求，并且创建一个新的套接字来与客户套接字创建连接通道，如果连接成功，就返回新创建的套接字的描述符，以后与客户套接字交换数据的是新创建的套接字；如果失败就返回INVALID_SOCKET。该函数的第一个参数指定处于监听状态的流套接字；操作系统利用第二个参数来返回新创建的套接字的地址结构；操作系统利用第三个参数来返回新创建的套接字的地址结构的长度。下面是一个调用accept的例子：
       struct sockaddr_in ServerSocketAddr;
       int addrlen;
       addrlen=sizeof(ServerSocketAddr);
       ServerSocket=accept(ListenSocket,(struct sockaddr *)&ServerSocketAddr,&addrlen);

十、connect函数
   int connect(
     SOCKET s,
     const struct sockaddr FAR *name,
     int namelen
   );
   客户程序调用connect函数来使客户Socket s与监听于name所指定的计算机的特定端口上的服务Socket进行连接。如果连接成功，connect返回0；如果失败则返回SOCKET_ERROR。下面是一个例子：
       struct sockaddr_in daddr;
       memset((void *)&daddr,0,sizeof(daddr));
       daddr.sin_family=AF_INET;
       daddr.sin_port=htons(8888);
       daddr.sin_addr.s_addr=inet_addr("133.197.22.4");
       connect(ClientSocket,(struct sockaddr *)&daddr,sizeof(daddr));

聂文龙 2007-09-24 14:54 发表评论

Visual C++线程同步技术

聂文龙 — Mon, 24 Sep 2007 06:53:00 GMT

线程同步的方式有：
　　临界区
　　管理事件内核对象
　　信号量内核对象
　　互斥内核对象
分别介绍如下：

使线程同步

　　在程序中使用多线程时，一般很少有多个线程能在其生命期内进行完全独立的操作。更多的情况是一些线程进行某些处理操作，而其他的线程必须对其处理结果进行了解。正常情况下对这种处理结果的了解应当在其处理任务完成后进行。

　　如果不采取适当的措施，其他线程往往会在线程处理任务结束前就去访问处理结果，这就很有可能得到有关处理结果的错误了解。例如，多个线程同时访问同一个全局变量，如果都是读取操作，则不会出现问题。如果一个线程负责改变此变量的值，而其他线程负责同时读取变量内容，则不能保证读取到的数据是经过写线程修改后的。

　　为了确保读线程读取到的是经过修改的变量，就必须在向变量写入数据时禁止其他线程对其的任何访问，直至赋值过程结束后再解除对其他线程的访问限制。象这种保证线程能了解其他线程任务处理结束后的处理结果而采取的保护措施即为线程同步。

　　线程同步是一个非常大的话题，包括方方面面的内容。从大的方面讲，线程的同步可分用户模式的线程同步和内核对象的线程同步两大类。用户模式中线程的同步方法主要有原子访问和临界区等方法。其特点是同步速度特别快，适合于对线程运行速度有严格要求的场合。

　　内核对象的线程同步则主要由事件、等待定时器、信号量以及信号灯等内核对象构成。由于这种同步机制使用了内核对象，使用时必须将线程从用户模式切换到内核模式，而这种转换一般要耗费近千个CPU周期，因此同步速度较慢，但在适用性上却要远优于用户模式的线程同步方式。

临界区

　　临界区（Critical Section）是一段独占对某些共享资源访问的代码，在任意时刻只允许一个线程对共享资源进行访问。如果有多个线程试图同时访问临界区，那么在有一个线程进入后其他所有试图访问此临界区的线程将被挂起，并一直持续到进入临界区的线程离开。临界区在被释放后，其他线程可以继续抢占，并以此达到用原子方式操作共享资源的目的。

　　临界区在使用时以CRITICAL_SECTION结构对象保护共享资源，并分别用EnterCriticalSection（）和LeaveCriticalSection（）函数去标识和释放一个临界区。所用到的CRITICAL_SECTION结构对象必须经过InitializeCriticalSection（）的初始化后才能使用，而且必须确保所有线程中的任何试图访问此共享资源的代码都处在此临界区的保护之下。否则临界区将不会起到应有的作用，共享资源依然有被破坏的可能。

图1 使用临界区保持线程同步

　　下面通过一段代码展示了临界区在保护多线程访问的共享资源中的作用。通过两个线程来分别对全局变量g_cArray[10]进行写入操作，用临界区结构对象g_cs来保持线程的同步，并在开启线程前对其进行初始化。为了使实验效果更加明显，体现出临界区的作用，在线程函数对共享资源g_cArray[10]的写入时，以Sleep（）函数延迟1毫秒，使其他线程同其抢占CPU的可能性增大。如果不使用临界区对其进行保护，则共享资源数据将被破坏（参见图1（a）所示计算结果），而使用临界区对线程保持同步后则可以得到正确的结果（参见图1（b）所示计算结果）。代码实现清单附下：

　　在使用临界区时，一般不允许其运行时间过长，只要进入临界区的线程还没有离开，其他所有试图进入此临界区的线程都会被挂起而进入到等待状态，并会在一定程度上影响。程序的运行性能。尤其需要注意的是不要将等待用户输入或是其他一些外界干预的操作包含到临界区。如果进入了临界区却一直没有释放，同样也会引起其他线程的长时间等待。换句话说，在执行了EnterCriticalSection（）语句进入临界区后无论发生什么，必须确保与之匹配的LeaveCriticalSection（）都能够被执行到。可以通过添加结构化异常处理代码来确保LeaveCriticalSection（）语句的执行。虽然临界区同步速度很快，但却只能用来同步本进程内的线程，而不可用来同步多个进程中的线程。

　　MFC为临界区提供有一个CCriticalSection类，使用该类进行线程同步处理是非常简单的，只需在线程函数中用CCriticalSection类成员函数Lock（）和UnLock（）标定出被保护代码片段即可。对于上述代码，可通过CCriticalSection类将其改写如下：

// MFC临界区类对象
CCriticalSection g_clsCriticalSection;
// 共享资源
char g_cArray[10];
UINT ThreadProc20(LPVOID pParam)
{
　// 进入临界区
　g_clsCriticalSection.Lock();
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[i] = 'a';
　　Sleep(1);
　}
　// 离开临界区
　g_clsCriticalSection.Unlock();
　return 0;
}
UINT ThreadProc21(LPVOID pParam)
{
　// 进入临界区
　g_clsCriticalSection.Lock();
　// 对共享资源进行写入操作
　for (int i = 0; i < 10; i++)
　{
　　g_cArray[10 - i - 1] = 'b';
　　Sleep(1);
　}
　// 离开临界区
　g_clsCriticalSection.Unlock();
　return 0;
}
……
void CSample08View::OnCriticalSectionMfc()
{
　// 启动线程
　AfxBeginThread(ThreadProc20, NULL);
　AfxBeginThread(ThreadProc21, NULL);
　// 等待计算完毕
　Sleep(300);
　// 报告计算结果
　CString sResult = CString(g_cArray);
　AfxMessageBox(sResult);
}