CSettingsStore Sınıfı

Kayıt defterine erişmek için kullandığınız nesne odaklı bir arabirim sağlayarak Windows API işlevlerini sarmalar.

Sözdizimi

class CSettingsStore : public CObject

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Açıklamalar

üye işlevleri CreateKey ve Open çok benzerdir. Kayıt defteri anahtarı zaten varsa CreateKey ve Open aynı şekilde çalışır. Ancak, kayıt defteri anahtarı yoksa CreateKey , bunu oluştururken Open bir hata değeri döndürür.

Örnek

Aşağıdaki örnekte sınıfının Open ve Read yöntemlerinin nasıl kullanılacağı gösterilmektedir CSettingsStore . Bu kod parçacığı, Araç İpucu Tanıtım örneğinin bir parçasıdır.

CSettingsStore reg(FALSE, TRUE);
DWORD dwEnableBalloonTips = 1;

if (reg.Open(_T("Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Advanced")) &&
    reg.Read(_T("EnableBalloonTips"), dwEnableBalloonTips))
{
   return dwEnableBalloonTips == 1;
}

Devralma Hiyerarşisi

CObject

CSettingsStore

Gereksinimler

Üst bilgi: afxsettingsstore.h

CSettingsStore::Close

Açık kayıt defteri anahtarını kapatır.

virtual void Close();

Açıklamalar

Varsayılan olarak, bu yöntem CSettingsStore Sınıfının yıkıcısından çağrılır.

CSettingsStore::CreateKey

Bir kayıt defteri anahtarı açar veya yoksa oluşturur.

virtual BOOL CreateKey(LPCTSTR pszPath);

Parametreler

pszPath
[in] Oluşturulacak veya açılacak anahtarın adını belirtir.

Dönüş Değeri

Başarılı olursa 0; aksi takdirde sıfır olmayan bir değer.

Açıklamalar

CreateKey , kayıt defteri sorgularının kökü olarak kullanır m_hKey . pszPath'i alt anahtarı m_hKeyolarak arar. Anahtar yoksa, CreateKey oluşturur. Aksi takdirde anahtarı açar. CreateKey ardından oluşturulan veya açılan anahtara ayarlar m_hKey .

CSettingsStore::CSettingsStore

Bir CSettngsStore nesnesi oluşturur.

CSettingsStore(
    BOOL bAdmin,
    BOOL bReadOnly);

Parametreler

bAdmin
[in] Nesnenin CSettingsStore yönetici modunda çalışıp davranmadığını belirten Boole parametresi.

bReadOnly
[in] Nesnenin CSettingsStore salt okunur modda oluşturulup oluşturulmadığını belirten Boole parametresi.

Açıklamalar

bAdmin TRUE olarak ayarlanırsa üye m_hKey değişkeni HKEY_LOCAL_MACHINE olarak ayarlanır. bAdmin'i FALSE olarak ayarlarsanız, m_hKey HKEY_CURRENT_USER olarak ayarlanır.

Güvenlik erişimi bReadOnly parametresine bağlıdır. bReadonly YANLIŞ ise, güvenlik erişimi KEY_ALL_ACCESS olarak ayarlanır. bReadyOnly TRUE ise, güvenlik erişimi KEY_QUERY_VALUE, KEY_NOTIFY ve KEY_ENUMERATE_SUB_KEYS birleşimine ayarlanır. Kayıt defteriyle birlikte güvenlik erişimi hakkında daha fazla bilgi için bkz . Kayıt Defteri Anahtarı Güvenliği ve Erişim Hakları.

Için yıkıcı CSettingsStore otomatik olarak yayınlar m_hKey .

CSettingsStore::D eleteKey

Bir anahtarı ve tüm alt öğelerini kayıt defterinden siler.

virtual BOOL DeleteKey(
    LPCTSTR pszPath,
    BOOL bAdmin = FALSE);

Parametreler

pszPath
[in] Silinecek anahtarın adı.

bAdmin
[in] Silinecek anahtarın konumunu belirten anahtar.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Nesne salt okunur moddaysa CSettingsStore bu yöntem başarısız olur.

bAdmin parametresi sıfırsa, DeleteKey HKEY_CURRENT_USER altında silinecek anahtarı arar. bAdmin sıfır değilse, DeleteKey HKEY_LOCAL_MACHINE altında silinecek anahtarı arar.

CSettingsStore::D eleteValue

değerinden m_hKeybir değer siler.

virtual BOOL DeleteValue(LPCTSTR pszValue);

Parametreler

pszValue
[in] Kaldırılacak değer alanını belirtir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

CSettingsStore::Open

Bir kayıt defteri anahtarı açar.

virtual BOOL Open(LPCTSTR pszPath);

Parametreler

pszPath
[in] Kayıt defteri anahtarının adı.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu yöntem belirtilen anahtarı başarıyla açtıktan sonra bu anahtarın tanıtıcısına ayarlanır m_hKey .

CSettingsStore::Read

Kayıt defterindeki bir anahtardan bir değer okur.

virtual BOOL Read(
    LPCTSTR pszKey,
    int& iVal);

virtual BOOL Read(
    LPCTSTR pszKey,
    DWORD& dwVal);

virtual BOOL Read(
    LPCTSTR pszKey,
    CString& sVal);

virtual BOOL Read(
    LPCTSTR pszKey,
    CStringList& scStringList);

virtual BOOL Read(
    LPCTSTR pszKey,
    CStringArray& scArray);

virtual BOOL Read(
    LPCTSTR pszKey,
    CDWordArray& dwcArray);

virtual BOOL Read(
    LPCTSTR pszKey,
    CWordArray& wcArray);

virtual BOOL Read(
    LPCTSTR pszKey,
    CByteArray& bcArray);

virtual BOOL Read(
    LPCTSTR pszKey,
    LPPOINT& lpPoint);

virtual BOOL Read(
    LPCTSTR pszKey,
    CRect& rect);

virtual BOOL Read(
    LPCTSTR pszKey,
    BYTE** ppData,
    UINT* pBytes);

virtual BOOL Read(
    LPCTSTR pszKey,
    CObList& list);

virtual BOOL Read(
    LPCTSTR pszKey,
    CObject& obj);

virtual BOOL Read(
    LPCTSTR pszKey,
    CObject*& pObj);

Parametreler

pszKey
[in] Kayıt defterinden okunacak değerin adını içeren null olarak sonlandırılan bir dizenin işaretçisi.

iVal
[out] Kayıt defteri anahtarından okunan değeri alan bir tamsayı değişkenine başvuru.

dwVal
[out] Kayıt defteri anahtarından okunan değeri alan 32 bit çift sözcük değişkenine başvuru.

sVal
[out] Kayıt defteri anahtarından okunan değeri alan bir dize değişkenine başvuru.

scStringList
[out] Kayıt defteri anahtarından okunan değeri alan bir dize listesi değişkenine başvuru.

scArray
[out] Kayıt defteri anahtarından okunan değeri alan bir dize dizisi değişkenine başvuru.

dwcArray
[out] Kayıt defteri anahtarından okunan değeri alan 32 bit çift sözcüklü dizi değişkenine başvuru.

wcArray
[out] Kayıt defteri anahtarından okunan değeri alan 16 bit sözcük dizisi değişkenine başvuru.

bcArray
[out] Kayıt defteri anahtarından okunan değeri alan bayt dizisi değişkenine başvuru.

lpPoint
[out] Kayıt defteri anahtarından okunan değeri alan bir POINT yapı işaretçisine başvuru.

Rect
[out] Kayıt defteri anahtarından okunan değeri alan bir CRect değişkenine başvuru.

ppData
[out] Kayıt defteri anahtarından okunan değeri alan verilere yönelik bir işaretçi.

pBytes
[out] İşaretsiz bir tamsayı değişkeninin işaretçisi. Bu değişken, ppData tarafından işaret edilen arabellek boyutunu alır.

listele
[out] Kayıt defteri anahtarından okunan değeri alan bir CObList değişkenine başvuru.

Obj
[out] Kayıt defteri anahtarından okunan değeri alan bir CObject değişkenine başvuru.

pObj
[out] Kayıt defteri anahtarından okunan değeri alan bir CObject değişken işaretçisine başvuru.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Read, alt anahtarı olarak pszKey'i m_hKey denetler.

CSettingsStore::Write

Kayıt defterine açık anahtarın altında bir değer yazar.

virtual BOOL Write(
    LPCTSTR pszKey,
    int iVal);

virtual BOOL Write(
    LPCTSTR pszKey,
    DWORD dwVal);

virtual BOOL Write(
    LPCTSTR pszKey,
    LPCTSTR pszVal);

virtual BOOL Write(
    LPCTSTR pszKey,
    CStringList& scStringList);

virtual BOOL Write(
    LPCTSTR pszKey,
    CByteArray& bcArray);

virtual BOOL Write(
    LPCTSTR pszKey,
    CStringArray& scArray);

virtual BOOL Write(
    LPCTSTR pszKey,
    CDWordArray& dwcArray);

virtual BOOL Write(
    LPCTSTR pszKey,
    CWordArray& wcArray);

virtual BOOL Write(
    LPCTSTR pszKey,
    const CRect& rect);

virtual BOOL Write(
    LPCTSTR pszKey,
    LPPOINT& lpPoint);

virtual BOOL Write(
    LPCTSTR pszKey,
    LPBYTE pData,
    UINT nBytes);

virtual BOOL Write(
    LPCTSTR pszKey,
    CObList& list);

virtual BOOL Write(
    LPCTSTR pszKey,
    CObject& obj);

virtual BOOL Write(
    LPCTSTR pszKey,
    CObject* pObj);

Parametreler

pszKey
[in] Ayarlanacağı değerin adını içeren bir dize işaretçisi.

iVal
[in] Depoacak verileri içeren bir tamsayı değişkenine başvuru.

dwVal
[in] Depoacak verileri içeren 32 bit çift sözcük değişkenine başvuru.

pszVal
[in] Depo edilecek verileri içeren null olarak sonlandırılan bir dize değişkeninin işaretçisi.

scStringList
[in] Depolanması gereken verileri içeren bir CStringList değişkenine başvuru.

bcArray
[in] Depoacak verileri içeren bir bayt dizisi değişkenine başvuru.

scArray
[in] Depoacak verileri içeren bir dize dizisi değişkenine başvuru.

dwcArray
[in] Depoacak verileri içeren 32 bit çift sözcüklü dizi değişkenine başvuru.

wcArray
[in] Depoacak verileri içeren 16 bit sözcük dizisi değişkenine başvuru.

Rect
[in] Depoacak verileri içeren bir CRect değişkenine başvuru.

lpPoint
[in] Depoacak verileri içeren bir POINT değişkenin işaretçisine başvuru.

pData
[in] Depolanmış verileri içeren bir arabelleğe işaretçi.

nBayt
[in] pData parametresinin işaret ettiği verilerin boyutunu bayt cinsinden belirtir.

listele
[in] Depoacak verileri içeren bir CObList değişkenine başvuru.

Obj
[in] Depoya kaydedilecek verileri içeren bir CObject değişkenine başvuru.

pObj
[in] Depoacak verileri içeren bir CObject değişkenin işaretçisine işaret eden işaretçi.

Dönüş Değeri

Başarılı olursa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Kayıt defterine yazmak için CSettingsStore nesnesi oluştururken bReadOnly değerini sıfır olmayan bir değere ayarlamanız gerekir. Daha fazla bilgi için bkz . CSettingsStore::CSettingsStore.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CWinAppEx Sınıfı