readme-chn.txt

电子狗加密程序,描述如何调用电子狗进行程序加密

           ===============================================
	   Win32 操作系统 C/C++ 语言软件狗接口模块使用说明
	   ===============================================
              版权所有 (C) 赛孚耐（北京）信息技术有限公司

 ========
 升级说明
 ========
      软件狗开发套件 V3.1 是在 V3.0 套件产品基础上进行的一次较大的升级。采用了
 我公司自主研发的第二代安全加密引擎，其中集成了最新的密码学理论和高强度加密算
 法，可以极大地提高受保护软件的防破解能力，并在此基础上增加了对 PDM 硬件的支
 持，此硬件具有更高的安全性，同时进一步增强了产品的稳定性。要获得更详细的信息，
 请查阅开发商手册的“升级说明”部分。
     软件狗开发套件 V3.0 在原套件的基础上增加了对 UDA 型 USB 软件狗的支持。并
 口软件狗和 USB 软件狗两种硬件完全兼容。加密后的 Win32 程序，在 Windows 98、
 Windows ME、Windows 2000、Windows XP、Windows Server 2003 操作系统下运行时以
 及加密后的程序在 Linux（内核 2.4 版以上）操作系统下运行时，既可以使用 USB 软
 件狗也可以使用并口软件狗。目前本版本在 Windows NT 4.0 下只支持并口狗。如果您
 需要在 Windows NT 4.0 下操作 USB 狗，请与我们联系。
 
 ========
 功能简介
 ========
    软件狗包括硬件狗部分及软件部分。硬件狗具有 100 字节的掉电保持的存储区。硬
 件狗的硬件在使用时应插在并口上或 USB 口上。软件由对硬件狗硬件调用的接口模块
 组成。
    硬件狗提供了两种功能：读、写存储区数据。
    读写存储区功能用于用户在硬件狗存储区中存取数据。使用读写功能时，您可以在
 程序中动态地写入变量，然后读出直接使用，来达到较高的加密效果；也可以将一些配
 置信息写入硬件狗中，记录用户的使用情况。
    灵活地使用以上功能就可以使您的软件不被非法使用，使您的权益得到保护。
    关于具体的加密技巧，请参阅开发商手册的“更好地使用软件狗开发套件”部分。

 ========
 文件清单
 ========
   readme-chn.txt        使用说明
   Stdafx.cpp		 编译预处理源文件
   Demodlg.cpp           例子程序源文件
   DogDemo.cpp           例子程序源文件
   DogDemo.dsp           例子程序工程文件
   DogDemo.dsw		 例子程序工程文件
   DogDemo.h		 例子程序头文件
   Demodlg.h		 例子程序头文件
   DogDemo.ico		 图标文件
   DogDemo.rc		 资源文件
   Resource.h            例子程序资源头文件
   softdog.h		 接口声明头文件
   Stdafx.h              编译预处理头文件
   RGDLW32V.OBJ          提供的API的接口文件
   DogDemo.rc2		 资源文件

 ==============
 已通过测试环境
 ==============
 本模块已通过 Microsoft Visual C++ 6.0 的测试。

 ================
 应用程序接口函数
 ================

    随盘发行的 RGDLW32V.OBJ 提供了 2 个外部函数，分别为： ReadDog 和
WriteDog。使用它们时需在应用程序中定义 3 个全局变量DogAddr、DogBytes 和
DogData。 
  
1.全局变量：
    共 3 个全局变量，全部在用户程序中定义。

    a.  unsigned short DogAddr   读写操作时指示软件狗内部用户区的首地址
                                 (0～99)，与DogBytes之和不超过100。

    b.  unsigned short DogBytes  读写操作(1～100)时的字节数。
                                 读、写操作时与DogAddr之和不超过 100。
                                 

    c.  void * DogData      指针变量，指向读、写操作的数据缓冲区。


2.接口函数的返回值：

    所有的接口函数在操作成功时均返回 0，操作失败时返回一错误代码。

3.接口函数使用方法：

    a. DWORD ReadDog(void)
         本函数读取软件狗存储器中用户区的数据，用户区的数据可由软件开发商写
         入。软件狗存储器中用户区首地址由 DogAddr指定，读取数据的长度（单位：
         字节）由 DogBytes 指定，读出的数据存入由 DogData 指向的缓冲区。
         当DogBytes为 0时，ReadDog把系列号放到由 DogData 指向的缓冲区。

         需要的全局变量 ：
           DogAddr, DogBytes, DogData。

    b. DWORD WriteDog(void)
         本函数把数据写入软件狗存储器中的用户区。软件狗存储器中用户区首地址
         由 DogAddr指定，写入数据的长度（单位：字节）由 DogBytes 指定，被写
         入的数据为由 DogData 指向的缓冲区内。

         需要的全局变量 ：
           DogAddr, DogBytes, DogData。


      具体使用方法见例子程序。

===========================================================================
  “狗”是北京金天地软件发展有限公司的注册商标，已授权赛孚耐（北京）
  信息技术有限公司使用。
===========================================================================