Megosztás a következőn keresztül:

CSettingsStore osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Körbefuttatja a Windows API-függvényeket, és egy objektumorientált felületet biztosít, amellyel hozzáférhet a beállításjegyzékhez.

Szemantika

class CSettingsStore : public CObject

Tagok

Nyilvános konstruktorok

Név Description
CSettingsStore::CSettingsStore Egy CSettingsStore objektumot hoz létre.

Nyilvános metódusok

Név Description
CSettingsStore::Close Bezárja a megnyitott beállításkulcsot.
CSettingsStore::CreateKey Megnyitja a megadott kulcsot, vagy létrehozza, ha nem létezik.
CSettingsStore::D eleteKey Törli a megadott kulcsot és annak összes gyermekét.
CSettingsStore::D eleteValue Törli a megnyitott kulcs megadott értékét.
CSettingsStore::Megnyitás Megnyitja a megadott kulcsot.
CSettingsStore::Read Egy megadott kulcsérték adatait kéri le.
CSettingsStore::Write Értéket ír a beállításjegyzékbe a nyitott kulcs alatt.

Megjegyzések

A tag függvények CreateKey és Open nagyon hasonlóak. Ha a beállításkulcs már létezik, CreateKey és Open ugyanúgy működik. Ha azonban a beállításkulcs nem létezik, akkor létrehozza azt, CreateKey míg Open a rendszer hibaértéket ad vissza.

Example

Az alábbi példa bemutatja, hogyan használható az osztály Megnyitás és Olvasás metódusa CSettingsStore . Ez a kódrészlet az Eszköztipp bemutató mintájának része.

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;
}

Öröklési hierarchia

CObject

CSettingsStore

Requirements

Fejléc: afxsettingsstore.h

CSettingsStore::Close

Bezárja a megnyitott beállításkulcsot.

virtual void Close();

Megjegyzések

Ez a metódus alapértelmezés szerint a CSettingsStore osztály destruktorából van meghívva.

CSettingsStore::CreateKey

Megnyitja a beállításkulcsot, vagy létrehozza, ha nem létezik.

virtual BOOL CreateKey(LPCTSTR pszPath);

Paraméterek

pszPath
[in] Megadja a létrehozandó vagy megnyitni kívánt kulcs nevét.

Visszaadott érték

0, ha sikeres; egyéb esetben nem érték.

Megjegyzések

CreateKey beállításjegyzék-lekérdezések gyökerét használja m_hKey . A pszPath alkulcsaként m_hKeykeres. Ha a kulcs nem létezik, CreateKey hozza létre. Ellenkező esetben megnyitja a kulcsot. CreateKey ezután a létrehozott vagy megnyitott kulcsra állítja m_hKey be.

CSettingsStore::CSettingsStore

Létrehoz egy objektumot CSettngsStore .

CSettingsStore(
    BOOL bAdmin,
    BOOL bReadOnly);

Paraméterek

bAdmin
[in] Logikai paraméter, amely megadja, hogy az CSettingsStore objektum rendszergazdai módban működik-e.

bReadOnly
[in] Logikai paraméter, amely meghatározza, hogy az CSettingsStore objektum írásvédett módban jön-e létre.

Megjegyzések

Ha a bAdmin értéke IGAZ, a m_hKey tagváltozó értéke HKEY_LOCAL_MACHINE. Ha a bAdmin értéke HAMIS, m_hKey akkor HKEY_CURRENT_USER értékre van állítva.

A biztonsági hozzáférés a bReadOnly paramétertől függ. Ha a bReadonly HAMIS, a biztonsági hozzáférés KEY_ALL_ACCESS lesz beállítva. Ha a bReadyOnly IGAZ, a biztonsági hozzáférés a KEY_QUERY_VALUE, KEY_NOTIFY és KEY_ENUMERATE_SUB_KEYS kombinációjára lesz beállítva. A beállításjegyzékkel együtt a biztonsági hozzáféréssel kapcsolatos további információkért lásd a beállításkulcs biztonsági és hozzáférési jogosultságai című témakört.

A kiadások destruktora CSettingsStorem_hKey automatikusan.

CSettingsStore::D eleteKey

Törli a kulcsot és annak összes gyermekét a beállításjegyzékből.

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

Paraméterek

pszPath
[in] A törölni kívánt kulcs neve.

bAdmin
[in] A törölni kívánt kulcs helyét meghatározó kapcsoló.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a metódus sikertelen lesz, ha az CSettingsStore objektum írásvédett módban van.

Ha a bAdmin paraméter nulla, DeleteKey a HKEY_CURRENT_USER alatt megkeresi a törölni kívánt kulcsot. Ha a bAdmin nem ero, DeleteKey a HKEY_LOCAL_MACHINE alatt megkeresi a törölni kívánt kulcsot.

CSettingsStore::D eleteValue

Egy értéket töröl a fájlból m_hKey.

virtual BOOL DeleteValue(LPCTSTR pszValue);

Paraméterek

pszValue
[in] Megadja az eltávolítandó értékmezőt.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

CSettingsStore::Megnyitás

Megnyitja a beállításkulcsot.

virtual BOOL Open(LPCTSTR pszPath);

Paraméterek

pszPath
[in] A beállításkulcs neve.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Miután ez a metódus sikeresen megnyitja a megadott kulcsot, a kulcs fogópontjára állítja m_hKey .

CSettingsStore::Read

Beolvas egy értéket a beállításjegyzék egyik kulcsából.

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);

Paraméterek

pszKey
[in] Mutasson egy null értékű sztringre, amely a beállításjegyzékből beolvasandó érték nevét tartalmazza.

iVal
[kifelé] Hivatkozás egy egész szám változóra, amely a beállításkulcsból olvassa be az értéket.

dwVal
[kifelé] Hivatkozás egy 32 bites kétszavas változóra, amely a beállításkulcsból olvassa be az értéket.

sVal
[kifelé] Hivatkozás egy sztringváltozóra, amely beolvassa az értéket a beállításkulcsból.

scStringList
[kifelé] Hivatkozás egy sztringlistaváltozóra, amely beolvassa az értéket a beállításkulcsból.

scArray
[kifelé] Hivatkozás egy sztringtömbváltozóra, amely beolvassa az értéket a beállításkulcsból.

dwcArray
[kifelé] Hivatkozás egy 32 bites kétszavas tömbváltozóra, amely beolvassa az értéket a beállításkulcsból.

wcArray
[kifelé] Hivatkozás egy 16 bites szótömbváltozóra, amely beolvassa az értéket a beállításkulcsból.

bcArray
[kifelé] Hivatkozás egy bájttömbváltozóra, amely a beállításkulcsból olvassa be az értéket.

lpPoint
[kifelé] Hivatkozás egy olyan struktúrára mutató mutatóra POINT , amely beolvassa az értéket a beállításkulcsból.

téglalap
[kifelé] Hivatkozás egy olyan CRect-változóra , amely a beállításkulcsból olvassa be az értéket.

ppData
[kifelé] Mutató a beállításkulcsból beolvasott értéket fogadó adatokra mutató mutatóra.

pBytes
[kifelé] Mutató egy aláíratlan egész szám változóra. Ez a változó megkapja annak a puffernek a méretét, amelyre a ppData mutat.

list
[kifelé] Hivatkozás egy olyan CObList-változóra , amely a beállításkulcsból olvassa be az értéket.

Obj
[kifelé] Hivatkozás egy CObject változóra, amely a beállításkulcsból olvassa be az értéket.

pObj
[kifelé] Hivatkozás egy olyan változóra mutató mutatóra CObject , amely beolvassa az értéket a beállításkulcsból.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Read a pszKey-t a következő alkulcsaként m_hKeyellenőrzi: .

CSettingsStore::Write

Értéket ír a beállításjegyzékbe a nyitott kulcs alatt.

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);

Paraméterek

pszKey
[in] Mutasson egy sztringre, amely tartalmazza a beállítani kívánt érték nevét.

iVal
[in] Hivatkozás egy olyan egész szám változóra, amely tartalmazza a tárolni kívánt adatokat.

dwVal
[in] Hivatkozás egy 32 bites kétszavas változóra, amely tartalmazza a tárolni kívánt adatokat.

pszVal
[in] Mutasson egy null értékű sztringváltozóra, amely tartalmazza a tárolni kívánt adatokat.

scStringList
[in] Hivatkozás a tárolni kívánt adatokat tartalmazó CStringList változóra.

bcArray
[in] Hivatkozás a tárolni kívánt adatokat tartalmazó bájttömbváltozóra.

scArray
[in] Hivatkozás a tárolni kívánt adatokat tartalmazó karakterlánctömbváltozóra.

dwcArray
[in] Hivatkozás egy 32 bites kétszavas tömbváltozóra, amely tartalmazza a tárolni kívánt adatokat.

wcArray
[in] Hivatkozás egy 16 bites szótömbváltozóra, amely tartalmazza a tárolni kívánt adatokat.

téglalap
[in] Hivatkozás a tárolni kívánt adatokat tartalmazó CRect-változóra .

lpPoint
[in] Hivatkozás egy olyan változóra mutató mutatóra POINT , amely tartalmazza az tárolandó adatokat.

pData
[in] Mutasson egy pufferre, amely tartalmazza a tárolni kívánt adatokat.

nBytes
[in] Bájtban adja meg azoknak az adatoknak a méretét, amelyekre a pData paraméter rámutat.

list
[in] Hivatkozás a tárolni kívánt adatokat tartalmazó CObList-változóra .

Obj
[in] Hivatkozás a tárolni kívánt adatokat tartalmazó CObject változóra.

pObj
[in] Mutató egy olyan változóra, CObject amely tartalmazza a tárolni kívánt adatokat.

Visszaadott érték

IGAZ, ha sikeres; egyéb esetben HAMIS.

Megjegyzések

A beállításjegyzékbe való íráshoz a BReadOnly értéket nemero értékre kell állítania egy CSettingsStore-objektum létrehozásakor. További információ: CSettingsStore::CSettingsStore.

Lásd még

hierarchiadiagram
osztályok
CWinAppEx osztály

  • Last updated on