zoukankan      html  css  js  c++  java
  • 注册表API函数

    注册表的操作,API为我们提供了大约25个函数。
    他提供了对注册表的读取,写入,删除,以及打开注册表及键值时所有函数,
    并且可以达到对注册表的备份,连接和对远端注册表进行查看等等。
    注册表对整个系统十分重要,你在进行操作时,一定要先考虑清楚。
    这些函数有:
    RegCloseKey RegConnectRegistry  RegCreateKey  RegCreateKeyEx  RegDeleteKey  RegDeleteVale  
    RegEnumKey  RegFlushKey  RegGetKeySecurity(此函数,98不适用)  RegLoadKey
    RegNotifyChangeKeyValue(98不适用)  RegOpenKey  RegOpenKeyEx  RegQueryInfoKey  RegQueryValue
    RegQueryValueEx  RegReplaceKey  RegRestoreKey(98不适用) RegSaveKey  RegSetKeySecurity(98不适用)   RegSetValue  RegSetValueEx  RegUnLoadKey 


      我们对经常使用的几个函数进行介绍。
      1·RegClose()
      原形:LONG RegCloseKey(
      HKEY hKey  // 释放已经打开的注册表句柄
         );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:关闭指定的主册表键,释放句柄。当对一个或多个键或值操作完成以后,需要关闭其键来进行保存操作结果。关闭一个键后,句柄变为非法,以使其不可再次被使用。为系统重新使用而释放句柄。
      例子
    BOOL bRet = TRUE;
    if( m_hKey == NULL )
      return( FALSE );
    bRet = ( ::RegCloseKey( m_hKey ) == ERROR_SUCCESS );
    m_hKey = NULL;
    return( bRet );

      2·RegCreateKeyEx()和RegCreateKey()
      原形:LONG RegCreateKeyEx(
            HKEY hKey,        // 主键名称
            LPCTSTR lpSubKey,     // 子键名称或路径
            DWORD Reserved,      // 保留,为0
            LPTSTR lpClass,      // 没弄懂,我设为空也差不多
            DWORD dwOptions,     
                 /* 对你建立的键的一些选项,可以是这些值:REG_OPTION_NON_VOLATILE,REG_OPTION_VOLATILE,REG_OPTION_BACKUP_RESTORE第一个是默认的了。一般用第一个就可以了。*/
            REGSAM samDesired,    // 设置你对你建立的这个键的访问权限
            LPSECURITY_ATTRIBUTES lpSecurityAttributes,
                 //不太明白
            PHKEY phkResult,     // 指向你建的句柄
            LPDWORD lpdwDisposition  //用来查看是打开一个已经有的键,还是新建了键
          );
      RegCreateKey()函数简单了不少,请自己看了。
      返回值:不成功返回非0,成功返回ERROR_SUCCESS.
      解释:打开指定的键或子键。如果要打开的键不存在的话,本函数会试图建立它。当在创建或打开注册表的键时,需要指定访问权限,而这些访问权限需要到一级。默认的权限是KEY_ALL_ACCESS权限。还有KEY_CREATE_LINK创建字符链权限,KEY_CREATE_SUB_KEY创建子键权限,KEY_EXECUTE读取键权限,KEY_NOTIFY获得修改键通知的权限,KEY_QUERY_VALUE查询键值的权限,KEY_SET_VALUE设置数据值的权限。注意不能在根一级建键,在注册表的根一级仅可有预定义的键。具体使用,请查看联机手册。
    例子:
       HKEY m_hkey;
       DWORD dwDisposition;
       long ret0=(::RegCreateKeyEx
          (HKEY_CURRENT_USER,"REGD\\",0,NULL,
          REG_OPTION_NON_VOLATILE,KEY_ALL_ACCESS,NULL,&m_hkey,&dwDisposition));
       if(ret0!=ERROR_SUCCESS) //如果无法打开hKEY,则终止程序的执行
       {
          MessageBox("错误: 无法打开有关的hKEY!");
          return;
       }
       if(dwDisposition==REG_OPENED_EXISTING_KEY)
          MessageBox("打开了一个已经存在的键");
       else
       {
         if(dwDisposition==REG_CREATED_NEW_KEY)
            MessageBox("建立一个新键");
       }
       RegClosekey(m_hkey);

      3·RegOpenKey()和RegOpenKeyEx()
      原形:LONG RegOpenKeyEx(
            HKEY hKey,     // 要打开主键名
            LPCTSTR lpSubKey, // 子键或路径
            DWORD ulOptions,  // 保留,为0
            REGSAM samDesired, // 操作权限标志
            PHKEY phkResult  // 指向你打开键的句柄
          );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS.
      解释:该函数负责打开指定的键或子键,如果不存在他不建立。其他和RegCreateKeyEx()和RegCreateKey()基本相同。

      4·RegDeleteKey()
      原形:LONG RegDeleteKey(
            HKEY hKey,     // 已打开的键的句柄
            LPCTSTR lpSubKey  // 要删除的子键或路径,传如""将删除key本身
           );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      该函数用来删除注册表中的一个键值的。在用此函数时需要注意98与NT的差异。在NT中在删除一个键之前,要求必须删除所有子键,需要从下向上递归删除所有子键,而WINDOWS98没有他那么复杂,只要删除键及其所有子键就可以啦。

      5·RegQueryValue()和RegQueryValueEx()
      原形:LONG RegQueryValueEx(
            HKEY hKey,      // 已打开的键的句柄
            LPTSTR lpValueName, // 要查询值的名称,传如""为查询键下的默认值
            LPDWORD lpReserved, // 保留,为0
            LPDWORD lpType,   // 查询的类型
            LPBYTE lpData,    // 数据存放的地址
            LPDWORD lpcbData   // 数据长度+1
          );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:读取某子键下特定名称的值。
      例子
       CString m_strQ;//用来存放查询来的字符串值 
       DWORD m_dwCount;//记录字符串的长度+1(包括NULL字符) 
       ::RegQueryValueEx(m_hkey,"",0,NULL,NULL,&m_dwCount);//先查询出字节空间  
       ret1=(::RegQueryValueEx
            (m_hkey,"",0,NULL,(unsigned char *)m_strQ.GetBuffer(m_dwCount),&m_kk));
       m_strQ.ReleaseBuffer();
       MessageBox(m_strQ);

      6·RegSetValue()和RegSetValueEX()
      原形:LONG RegSetValueEx(
            HKEY hKey,      // 已打开的键的句柄
            LPCTSTR lpValueName, // 要查询值的名称,传如""为查询键下的默认值
            DWORD Reserved,   // 保留
            DWORD dwType,    // 变量的类型
            CONST BYTE *lpData, // 变量数据的地址
            DWORD cbData     // 变量的长度
          );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:设置某子键下特定名称的值。

      7·RegEnumValue()
      原形:LONG RegEnumValue(
            HKEY hKey,       // 要查询的已打开的键的句柄
            DWORD dwIndex,     // 读取名称的索引号
            LPTSTR lpValueName,   // 返回所读取的名称
            LPDWORD lpcbValueName, // 返回读取名称的长度,不含chr(0)
            LPDWORD lpReserved,   // 保留,为0
            LPDWORD lpType,     // 返回所读取的数据类型
            LPBYTE lpData,     // 返回所读取的数据
            LPDWORD lpcbData    // 返回所读取的数据长度
         );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:列出某Key的所有名称的值,变化索引即可遍历整个键下的名称和数据。

      8·RegDeleteValue()
      原形:LONG RegDeleteValue(
            HKEY hKey,      // 要删除的键的句柄
            LPCTSTR lpValueName  // 要删除的名称
          );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:删除某Key的某一名称

      9·RegEnumKey()和RegEnumKeyEx()
      原形:LONG RegEnumKeyEx(
            HKEY hKey,     // 要列举的键的句柄
            DWORD dwIndex,   // 索引
            LPTSTR lpName,   // 子键的名称
            LPDWORD lpcbName,  // 子键名称的长度
            LPDWORD 
     
     lpReserved, // 保留
            LPTSTR lpClass,   // address of buffer for class string
            LPDWORD lpcbClass, // address for size of class buffer
            PFILETIME lpftLastWriteTime 
               // address for time key last written to
          );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      返回注册表键及其子键的详细信息。

      10·RegQueryInfoKey()
      原形:LONG RegQueryInfoKey(
            HKEY hKey,        // 已打开的键的句柄
            LPTSTR lpClass,      // 类型名称,仅使用于NT。若不使用则传入Null
            LPDWORD lpcbClass,    // 类型名称的长度
            LPDWORD lpReserved,    // 保留
            LPDWORD lpcSubKeys,    // 返回子键的数目              
            LPDWORD lpcbMaxSubKeyLen, // 返回最长的子键长度              
            LPDWORD lpcbMaxClassLen, // 返回最长的类长度 
            LPDWORD lpcValues,    // 返回值的数目              
            LPDWORD lpcbMaxValueNameLen, // 返回最长的值项名称的长度
            LPDWORD lpcbMaxValueLen, // 返回最长的值的长度
            LPDWORD lpcbSecurityDescriptor, //返回安全描述,仅适用于 NT
            PFILETIME lpftLastWriteTime  // 返回键最后被写入的时间,仅适用于 NT
         );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:返回注册表键的信息,包括类名、子键数量、最长子键名、值的数量、最长值数据、安全描述符的长度以及上一次写入的时间等。

      11·RegLoadKey()
      原形:LONG RegLoadKey(
            HKEY hKey,    // 打开的句柄
            LPCTSTR lpSubKey, //子键的路径          
            LPCTSTR lpFile  // 要写入注册表信息的文件
          );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:从指定的文件恢复注册表键的子键信息到注册表。

      12·RegReplaceKey()
      原形:LONG RegReplaceKey(
            HKEY hKey,     // handle to open key
            LPCTSTR lpSubKey, // address of name of subkey
            LPCTSTR lpNewFile, // 在替换前生成新的备份文件
            LPCTSTR lpOldFile // 需要覆盖上注册表的文件
          );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:从指定的文件恢复注册表键的子键信息到注册表并替换原有的值,并生成新的备份文件

      13· RegSaveKey()
      LONG RegSaveKey(
         HKEY hKey,    // 要保存的句柄
         LPCTSTR lpFile, // 保存子键的文件
         LPSECURITY_ATTRIBUTES lpSecurityAttributes    //不太懂          
        );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:保存键及其子键信息到指定的文件。

      14· RegConnectRegistry()
      原形:LONG RegConnectRegistry(
            LPTSTR lpMachineName, //远程计算机的名称
            HKEY hKey,    // 预先注册的句柄
            PHKEY phkResult  // 远程计算机上的句柄
         );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      解释:连接到远程系统的注册表。

      15·RegNotifyChangeKeyValue()
      当修改指定的注册表对象时提供通知。

      16· RegUnloadKey()
      LONG RegUnLoadKey(
         HKEY hKey,     // handle to open key
         LPCTSTR lpSubKey  // address of name of subkey to unload
        );
      返回值:不成功返回非0,成功返回ERROR_SUCCESS
      删除注册表键及其所有的子键。
     

  • 相关阅读:
    8.3.ZooKeeper集群安装配置
    Shiro Demo 示例(SpringMVC-Mybatis-Shiro-redis)
    Shiro 学习
    JavaWeb项目:Shiro实现简单的权限控制(整合SSM)
    权限管理——权限模型和权限控制
    Java程序员面试题集(151-180)
    Java面试题集(136-150)
    Java面试题集(131-135)
    Java面试题集(116-135)
    Java面试题集(1-50)
  • 原文地址:https://www.cnblogs.com/ahuo/p/883250.html
Copyright © 2011-2022 走看看