Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

115 lines
4.3 KiB

/*==========================================================================
*
* Copyright (C) 1999 Microsoft Corporation. All Rights Reserved.
*
* File: creg.h
* Content: definition of the CRegistry class
*
* History:
* Date By Reason
* ==== == ======
* 07/16/99 rodtoll Created
* 08/18/99 rodtoll Added Register/UnRegister that can be used to
* allow COM objects to register themselves.
* 08/25/99 rodtoll Updated to provide read/write of binary (blob) data
* 10/07/99 rodtoll Updated to work in Unicode
* 10/27/99 pnewson added Open() call that takes a GUID
* 01/18/00 mjn Added GetMaxKeyLen function
* 01/24/00 mjn Added GetValueSize function
* 04/05/2000 jtk Changed GetVauleSize to GetValueLength and modified to return WCHAR lengths
* 04/21/2000 rodtoll Bug #32889 - Does not run on Win2k on non-admin account
* rodtoll Bug #32952 - Does not run on Win95 GOLD w/o IE4 -- modified
* to allow reads of REG_BINARY when expecting REG_DWORD
* 07/09/2000 rodtoll Added signature bytes
* 08/28/2000 masonb Voice Merge: Modified platform checks to use osind.cpp layer (removed CRegistry::CheckUnicodePlatform)
* 04/13/2001 VanceO Moved granting registry permissions into common, and
* added DeleteValue and EnumValues.
* 06/19/2001 RichGr DX8.0 added special security rights for "everyone" - remove them if
* they exist with new RemoveAllAccessSecurityPermissions() method.
*
***************************************************************************/
#ifndef __CREGISTRY_H
#define __CREGISTRY_H
// Useful definition
#define MAX_REGISTRY_STRING_SIZE _MAX_PATH+1
#define DPN_KEY_ALL_ACCESS ((KEY_ALL_ACCESS & ~WRITE_DAC) & ~WRITE_OWNER)
#define VSIG_CREGISTRY 'GERV'
#define VSIG_CREGISTRY_FREE 'GER_'
// CRegistry
//
// This class handles reading/writing to the windows registry. Each instance
// of the CRegistry class is attached to a single registry handle, which is
// an open handle to a point in the registry tree.
//
class CRegistry
{
public:
CRegistry();
CRegistry( const CRegistry &registry );
CRegistry( const HKEY branch, LPWSTR pathName, BOOL fReadOnly = TRUE, BOOL create = FALSE );
~CRegistry();
BOOL EnumKeys( LPWSTR lpwStrName, LPDWORD lpdwStringLen, DWORD index = 0 );
BOOL EnumValues( LPWSTR lpwStrName, LPDWORD lpdwStringLen, DWORD index = 0 );
BOOL Open( const HKEY branch, const LPCWSTR pathName, BOOL fReadOnly = TRUE, BOOL create = FALSE, BOOL fCustomSAM = FALSE, REGSAM samCustom = NULL);
BOOL Open( const HKEY branch, const GUID* lpguid, BOOL fReadOnly = TRUE, BOOL create = FALSE, BOOL fCustomSAM = FALSE, REGSAM samCustom = NULL);
BOOL Close();
BOOL IsOpen() { return m_isOpen; };
BOOL DeleteSubKey( LPCWSTR keyName );
BOOL DeleteSubKey( const GUID *pGuidName );
BOOL DeleteValue( LPCWSTR valueName );
BOOL ReadGUID( LPCWSTR keyName, GUID &guid );
BOOL WriteGUID( LPCWSTR keyName, const GUID &guid );
BOOL WriteString( LPCWSTR keyName, const LPCWSTR lpwstrValue );
BOOL ReadString( LPCWSTR keyName, LPWSTR lpwstrValue, LPDWORD lpdwLength );
BOOL WriteDWORD( LPCWSTR keyName, DWORD value );
BOOL ReadDWORD( LPCWSTR keyName, DWORD &result );
BOOL WriteBOOL( LPCWSTR keyName, BOOL value );
BOOL ReadBOOL( LPCWSTR keyName, BOOL &result );
BOOL ReadBlob( LPCWSTR keyName, LPBYTE lpbBuffer, LPDWORD lpdwSize );
BOOL WriteBlob( LPCWSTR keyName, LPBYTE lpbBuffer, DWORD dwSize );
BOOL GetMaxKeyLen( DWORD &dwMaxKeyLen );
BOOL GetValueLength( const LPCWSTR keyName, DWORD *const pdwValueLength );
BOOL GrantAllAccessSecurityPermissions();
BOOL RemoveAllAccessSecurityPermissions();
static BOOL Register( LPCWSTR lpszProgID, LPCWSTR lpszDesc, LPCWSTR lpszProgName, GUID guidCLSID, LPCWSTR lpszVerIndProgID );
static BOOL UnRegister( GUID guidCLSID );
// Data access functions
operator HKEY() const { return m_regHandle; };
HKEY GetBaseHandle() const { return m_baseHandle; };
HKEY GetHandle() const { return m_regHandle; };
protected:
DWORD m_dwSignature; // Signature
BOOL m_fReadOnly;
BOOL m_isOpen; // BOOL indicating if the object is open
HKEY m_regHandle; // Handle to the registry which is represented by this object
HKEY m_baseHandle; // Handle to the root of the part of the registry
// this object is in. E.g. HKEY_LOCAL_MACHINE
};
#endif