regentry.cpp

来自「Windows CE 6.0 Server 源码」· C++ 代码 · 共 409 行

//
// Copyright (c) Microsoft Corporation.  All rights reserved.
//
//
// Use of this source code is subject to the terms of the Microsoft shared
// source or premium shared source license agreement under which you licensed
// this source code. If you did not accept the terms of the license agreement,
// you are not authorized to use this source code. For the terms of the license,
// please see the license agreement between you and Microsoft or, if applicable,
// see the SOURCE.RTF on your install media or the root of your tools installation.
// THE SOURCE CODE IS PROVIDED "AS IS", WITH NO WARRANTIES.
//
/*****************************************************************/
/**               Microsoft Windows for Workgroups              **/
/*****************************************************************/

/*
    regentry.cpp
    registry access classes

    This file contains classes which enable
    convenient access the registry for entries.

    FILE HISTORY:
        lens    10/15/95    Created
        ChrisPi 6/21/96     Added GetBinary(), SetValue() for binary
*/

#include <pch.h>
#pragma hdrstop
#include "regentry.h"

RegEntry::RegEntry(LPCTSTR pszSubKey, HKEY hkey, BOOL fCreate, REGSAM samDesired)
 : m_pbValueBuffer(NULL),
   m_cbValueBuffer(0),
   m_fValuesWritten(FALSE),
   m_szNULL('\0')
{
    // Open with desired access if it is specified explicitly; otherwise, use
    // the default access.
    if (fCreate) {

        m_error = RegCreateKeyEx(hkey, 
                                pszSubKey, 
                                0, 
                                NULL, 
                                0,//REG_OPTION_NON_VOLATILE,
                                samDesired, 
                                NULL, 
                                &m_hkey, 
                                &m_dwDisposition);
    }
    else {
        m_error = RegOpenKeyEx(hkey, pszSubKey, 0, samDesired, &m_hkey);
        m_dwDisposition = REG_OPENED_EXISTING_KEY;
    }

    m_fhkeyValid = (m_error == ERROR_SUCCESS);
}


RegEntry::~RegEntry()
{
    ChangeKey(NULL);
    delete [] m_pbValueBuffer;
}


VOID RegEntry::ChangeKey(HKEY hNewKey)
{
    // hNewKey assumed to be valid or never used
    // (as in destructor).

    if (m_fValuesWritten) {
        FlushKey();     
    }
    if (m_fhkeyValid) {
        RegCloseKey(m_hkey); 
    }
    m_hkey = hNewKey;   
}


VOID RegEntry::UpdateWrittenStatus()
{
    if (m_error == ERROR_SUCCESS) {
        m_fValuesWritten = TRUE;
    }
}

long RegEntry::SetValue(LPCTSTR pszValue, LPCTSTR string)
{
    if (m_fhkeyValid) {
        m_error = RegSetValueEx(m_hkey, pszValue, 0, REG_SZ,
                    (LPBYTE)string, (lstrlen(string)+1) * sizeof(*string));
        UpdateWrittenStatus();
    }
    return m_error;
}

long RegEntry::SetValue(LPCTSTR pszValue, unsigned long dwNumber)
{
    if (m_fhkeyValid) {
        m_error = RegSetValueEx(m_hkey, pszValue, 0, REG_BINARY,
                    (LPBYTE)&dwNumber, sizeof(dwNumber));
        UpdateWrittenStatus();
    }
    return m_error;
}

long RegEntry::SetValue(LPCTSTR pszValue,
                        void* pData,
                        DWORD cbLength)
{
    if (m_fhkeyValid) {
        m_error = RegSetValueEx(    m_hkey,
                                pszValue,
                                0,
                                REG_BINARY,
                                (LPBYTE) pData,
                                cbLength);
        UpdateWrittenStatus();
    }
    return m_error;
}

long RegEntry::DeleteValue(LPCTSTR pszValue)
{
    if (m_fhkeyValid) {
        m_error = RegDeleteValue(m_hkey, pszValue);
        UpdateWrittenStatus();
    }
    return m_error;
}

long RegEntry::GetNumber(LPCTSTR pszValue, long dwDefault)
{
    DWORD   dwType = REG_BINARY;
    long    dwNumber = 0L;
    DWORD   dwSize = sizeof(dwNumber);

    if (m_fhkeyValid) {
        m_error = RegQueryValueEx(m_hkey, pszValue, 0, &dwType, (LPBYTE)&dwNumber,
                    &dwSize);
    }
    
    // If the call succeeded, make sure that the returned data matches our
    // expectations.
    ASSERT(m_error != ERROR_SUCCESS || 
            (REG_BINARY == dwType && sizeof(dwNumber) == dwSize) ||
            REG_DWORD == dwType);

    if (m_error != ERROR_SUCCESS)
        dwNumber = dwDefault;
    
    return dwNumber;
}


LPTSTR RegEntry::GetString(LPCTSTR pszValueName)
{
    DWORD   dwType = REG_SZ;
    DWORD   length = m_cbValueBuffer;

    if (m_fhkeyValid) {
        m_error = RegQueryValueEx( m_hkey,
                                  pszValueName,
                                  0,
                                  &dwType,
                                  m_pbValueBuffer,
                                  &length );
        // Try again with a larger buffer if the first one is too small,
        // or if there wasn't already a buffer allocated.
        if ((ERROR_SUCCESS == m_error && NULL == m_pbValueBuffer)
            || ERROR_MORE_DATA == m_error) {
            
            ASSERT(length > m_cbValueBuffer);

            ResizeValueBuffer(length);

            m_error = RegQueryValueEx( m_hkey,
                                      pszValueName,
                                      0,
                                      &dwType,
                                      m_pbValueBuffer,
                                      &length );
        }
        if (m_error == ERROR_SUCCESS) {
            if ((dwType != REG_SZ) && (dwType != REG_EXPAND_SZ)) {
                m_error = ERROR_INVALID_PARAMETER;
            }
        }
    }
    if ((m_error != ERROR_SUCCESS) || (length == 0)) {
        return &m_szNULL;
    }
    return (LPTSTR) m_pbValueBuffer;
}

DWORD RegEntry::GetBinary(  LPCTSTR pszValueName,
                            void** ppvData)
{
    ASSERT(ppvData);
    DWORD   dwType = REG_BINARY;
    DWORD   length = m_cbValueBuffer;

    if (m_fhkeyValid) {
        m_error = RegQueryValueEx( m_hkey,
                                  pszValueName,
                                  0,
                                  &dwType,
                                  m_pbValueBuffer,
                                  &length );
        // Try again with a larger buffer if the first one is too small,
        // or if there wasn't already a buffer allocated.
        if ((ERROR_SUCCESS == m_error && NULL == m_pbValueBuffer)
            || ERROR_MORE_DATA == m_error) {
            
            ASSERT(length > m_cbValueBuffer);

            ResizeValueBuffer(length);

            m_error = RegQueryValueEx( m_hkey,
                                      pszValueName,
                                      0,
                                      &dwType,
                                      m_pbValueBuffer,
                                      &length );
        }
        if (m_error == ERROR_SUCCESS) {
            if (dwType != REG_BINARY) {
                m_error = ERROR_INVALID_PARAMETER;
            }
        }
    }
    if ((m_error != ERROR_SUCCESS) || (length == 0)) {
        *ppvData = NULL;
        length = 0;
    }
    else
    {
        *ppvData = m_pbValueBuffer;
    }
    return length;
}

// BUGBUG - Use LocalReAlloc instead of new/delete?
VOID RegEntry::ResizeValueBuffer(DWORD length)
{
    LPBYTE pbNewBuffer;

    if ((m_error == ERROR_SUCCESS || m_error == ERROR_MORE_DATA)
        && (length > m_cbValueBuffer)) {
        pbNewBuffer = new BYTE[length];
        if (pbNewBuffer) {
            delete [] m_pbValueBuffer;
            m_pbValueBuffer = pbNewBuffer;
            m_cbValueBuffer = length;
        }
        else {
            m_error = ERROR_NOT_ENOUGH_MEMORY;
        }
    }
}

// BUGBUG - Support other OpenKey switches from constructor
VOID RegEntry::MoveToSubKey(LPCTSTR pszSubKeyName)
{
    HKEY    _hNewKey;

    if (m_fhkeyValid) {
        m_error = RegOpenKeyEx ( m_hkey,
                              pszSubKeyName,0,0,
                              &_hNewKey );
        if (m_error == ERROR_SUCCESS) {
            ChangeKey(_hNewKey);
        }
    }
}

RegEnumValues::RegEnumValues(RegEntry *pReqRegEntry)
 : m_pRegEntry(pReqRegEntry),
   m_iEnum(0),
   m_pchName(NULL),
   m_pbValue(NULL)
{
    m_error = m_pRegEntry->GetError();
    if (m_error == ERROR_SUCCESS) {
        m_error = RegQueryInfoKey (m_pRegEntry->GetKey(), // Key
                                   NULL,                // Buffer for class string
                                   NULL,                // Size of class string buffer
                                   NULL,                // Reserved
                                   NULL,                // Number of subkeys
                                   NULL,                // Longest subkey name
                                   NULL,                // Longest class string
                                   &m_cEntries,         // Number of value entries
                                   &m_cMaxValueName,    // Longest value name
                                   &m_cMaxData,         // Longest value data
                                   NULL,                // Security descriptor
                                   NULL );              // Last write time
    }
    if (m_error == ERROR_SUCCESS) {
        if (m_cEntries != 0) {
            m_cMaxValueName++;  // REG_SZ needs one more for null
            m_cMaxData++;       // REG_SZ needs one more for null
            m_pchName = new TCHAR[m_cMaxValueName];
            if (!m_pchName) {
                m_error = ERROR_NOT_ENOUGH_MEMORY;
            }
            else {
                if (m_cMaxData) {
                    m_pbValue = new BYTE[m_cMaxData];
                    if (!m_pbValue) {
                        m_error = ERROR_NOT_ENOUGH_MEMORY;
                    }
                }
            }
        }
    }
}

RegEnumValues::~RegEnumValues()
{
    delete m_pchName;
    delete m_pbValue;
}

long RegEnumValues::Next()
{
    if (m_error != ERROR_SUCCESS) {
        return m_error;
    }
    if (m_cEntries == m_iEnum) {
        return ERROR_NO_MORE_ITEMS;
    }

    DWORD   cchName = m_cMaxValueName;

    m_dwDataLength = m_cMaxData;
    m_error = RegEnumValue ( m_pRegEntry->GetKey(), // Key
                            m_iEnum,               // Index of value
                            m_pchName,             // Address of buffer for value name
                            &cchName,            // Address for size of buffer
                            NULL,                // Reserved
                            &m_dwType,             // Data type
                            m_pbValue,             // Address of buffer for value data
                            &m_dwDataLength );     // Address for size of data
    m_iEnum++;
    return m_error;
}

RegEnumSubKeys::RegEnumSubKeys(RegEntry *pReqRegEntry)
 : m_pRegEntry(pReqRegEntry),
   m_iEnum(0),
   m_pchName(NULL),
   m_cEntries(0),
   m_cMaxKeyName(0)
{
    m_error = m_pRegEntry->GetError();
    if (m_error == ERROR_SUCCESS) {
        m_error = RegQueryInfoKey ( m_pRegEntry->GetKey(), // Key
                                   NULL,                // Buffer for class string
                                   NULL,                // Size of class string buffer
                                   NULL,                // Reserved
                                   &m_cEntries,           // Number of subkeys
                                   &m_cMaxKeyName,        // Longest subkey name
                                   NULL,                // Longest class string
                                   NULL,                // Number of value entries
                                   NULL,                // Longest value name
                                   NULL,                // Longest value data
                                   NULL,                // Security descriptor
                                   NULL );              // Last write time
    }
    if (m_error == ERROR_SUCCESS) {
        if (m_cEntries != 0) {
            m_cMaxKeyName = m_cMaxKeyName + 1; // needs one more for null
            m_pchName = new TCHAR[m_cMaxKeyName];
            if (!m_pchName) {
                m_error = ERROR_NOT_ENOUGH_MEMORY;
            }
        }
    }
}

RegEnumSubKeys::~RegEnumSubKeys()
{
    delete m_pchName;
}

long RegEnumSubKeys::Next()
{
    if (m_error != ERROR_SUCCESS) {
        return m_error;
    }
    if (m_cEntries == m_iEnum) {
        return ERROR_NO_MORE_ITEMS;
    }

    DWORD   cchName = m_cMaxKeyName;

    m_error = RegEnumKeyEx ( m_pRegEntry->GetKey(), // Key
                          m_iEnum,               // Index of value
                          m_pchName,             // Address of buffer for subkey name
                          &cchName,             // Size of buffer
                          NULL,NULL,NULL,NULL); 
    m_iEnum++;
    return m_error;
}