Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Verpakt Windows API-functies die een objectgeoriënteerde interface bieden die u gebruikt voor toegang tot het register.
Syntaxis
class CSettingsStore : public CObject
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CSettingsStore::CSettingsStore | Maakt een CSettingsStore object. |
Openbare methoden
| Naam | Description |
|---|---|
| CSettingsStore::Sluiten | Hiermee sluit u de geopende registersleutel. |
| CSettingsStore::CreateKey | Hiermee opent u de opgegeven sleutel of maakt u deze als deze niet bestaat. |
| CSettingsStore::D eleteKey | Hiermee verwijdert u de opgegeven sleutel en alle onderliggende items. |
| CSettingsStore::D eleteValue | Hiermee verwijdert u de opgegeven waarde van de geopende sleutel. |
| CSettingsStore::Open | Hiermee opent u de opgegeven sleutel. |
| CSettingsStore::Lezen | Haalt de gegevens voor een opgegeven sleutelwaarde op. |
| CSettingsStore::Schrijven | Hiermee schrijft u een waarde naar het register onder de open sleutel. |
Opmerkingen
De lidfuncties CreateKey en Open zijn vergelijkbaar. Als de registersleutel al bestaat CreateKey en Open op dezelfde manier werkt. Als de registersleutel echter niet bestaat, CreateKey wordt deze gemaakt terwijl Open er een foutwaarde wordt geretourneerd.
Example
In het volgende voorbeeld ziet u hoe u de open- en leesmethoden van de CSettingsStore klasse gebruikt. Dit codefragment maakt deel uit van het voorbeeld tooltipdemo.
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;
}
Overnamehiërarchie
CSettingsStore
Requirements
Koptekst: afxsettingsstore.h
CSettingsStore::Sluiten
Hiermee sluit u de geopende registersleutel.
virtual void Close();
Opmerkingen
Deze methode wordt standaard aangeroepen vanuit de destructor van de CSettingsStore-klasse.
CSettingsStore::CreateKey
Hiermee opent u een registersleutel of maakt u deze als deze niet bestaat.
virtual BOOL CreateKey(LPCTSTR pszPath);
Parameterwaarden
pszPath
[in] Hiermee geeft u de naam van een sleutel die moet worden gemaakt of geopend.
Retourwaarde
0 indien geslaagd; anders een niet-nulwaarde.
Opmerkingen
CreateKey gebruikt m_hKey als de hoofdmap van registervragen. Het zoekt naar pszPath als een subsleutel van m_hKey. Als de sleutel niet bestaat, CreateKey maakt u deze. Anders wordt de sleutel geopend.
CreateKey wordt vervolgens ingesteld m_hKey op de gemaakte of geopende sleutel.
CSettingsStore::CSettingsStore
Hiermee maakt u een CSettngsStore object.
CSettingsStore(
BOOL bAdmin,
BOOL bReadOnly);
Parameterwaarden
bAdmin
[in] Booleaanse parameter die aangeeft of het CSettingsStore object zich in de beheerdersmodus gedraagt.
bReadOnly
[in] Booleaanse parameter die aangeeft of het object wordt gemaakt in de CSettingsStore modus Alleen-lezen.
Opmerkingen
Als bAdmin is ingesteld op TRUE, wordt de m_hKey lidvariabele ingesteld op HKEY_LOCAL_MACHINE. Als u bAdmin instelt op FALSE, m_hKey wordt ingesteld op HKEY_CURRENT_USER.
De beveiligingstoegang is afhankelijk van de parameter bReadOnly . Als bReadonly ONWAAR is, wordt de beveiligingstoegang ingesteld op KEY_ALL_ACCESS. Als bReadyOnly TRUE is, wordt de beveiligingstoegang ingesteld op een combinatie van KEY_QUERY_VALUE, KEY_NOTIFY en KEY_ENUMERATE_SUB_KEYS. Zie Registersleutelbeveiliging en toegangsrechten voor meer informatie over beveiligingstoegang in combinatie met het register.
De destructor voor CSettingsStore releases m_hKey automatisch.
CSettingsStore::D eleteKey
Hiermee verwijdert u een sleutel en alle onderliggende items uit het register.
virtual BOOL DeleteKey(
LPCTSTR pszPath,
BOOL bAdmin = FALSE);
Parameterwaarden
pszPath
[in] De naam van de sleutel die u wilt verwijderen.
bAdmin
[in] Schakeloptie waarmee de locatie van de sleutel wordt opgegeven die moet worden verwijderd.
Retourwaarde
Niet-nul indien geslaagd; anders 0.
Opmerkingen
Deze methode mislukt als het object zich in de CSettingsStore modus Alleen-lezen bevindt.
Als de parameter bAdmin nul is, DeleteKey zoekt u naar de sleutel die moet worden verwijderd onder HKEY_CURRENT_USER. Als bAdmin niet-nul is, DeleteKey zoekt u naar de sleutel die moet worden verwijderd onder HKEY_LOCAL_MACHINE.
CSettingsStore::D eleteValue
Hiermee verwijdert u een waarde uit m_hKey.
virtual BOOL DeleteValue(LPCTSTR pszValue);
Parameterwaarden
pszValue
[in] Hiermee geeft u het waardeveld dat moet worden verwijderd.
Retourwaarde
Niet-nul indien geslaagd; anders 0.
CSettingsStore::Open
Hiermee opent u een registersleutel.
virtual BOOL Open(LPCTSTR pszPath);
Parameterwaarden
pszPath
[in] De naam van een registersleutel.
Retourwaarde
Niet-nul indien geslaagd; anders 0.
Opmerkingen
Nadat deze methode de opgegeven sleutel heeft geopend, wordt deze ingesteld m_hKey op de ingang van deze sleutel.
CSettingsStore::Lezen
Leest een waarde uit een sleutel in het register.
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);
Parameterwaarden
pszKey
[in] Aanwijzer naar een door null beëindigde tekenreeks die de naam van de waarde bevat die uit het register moet worden gelezen.
iVal
[uit] Verwijzing naar een geheel getalvariabele die de waarde ontvangt die wordt gelezen uit de registersleutel.
dwVal
[uit] Verwijzing naar een 32-bits variabele met dubbel woord die de waarde van de registersleutel ontvangt.
sVal
[uit] Verwijzing naar een tekenreeksvariabele die de waarde ontvangt die wordt gelezen uit de registersleutel.
scStringList
[uit] Verwijzing naar een lijstvariabele met tekenreeksen die de waarde ontvangt die wordt gelezen uit de registersleutel.
scArray
[uit] Verwijzing naar een tekenreeksmatrixvariabele die de waarde ontvangt die wordt gelezen uit de registersleutel.
dwcArray
[uit] Verwijzing naar een 32-bits matrixvariabele met dubbele woorden die de waarde van de registersleutel ontvangt.
wcArray
[uit] Verwijzing naar een 16-bits matrixvariabele die de waarde van de registersleutel ontvangt.
bcArray
[uit] Verwijzing naar een bytematrixvariabele die de waarde van de registersleutel ontvangt.
lpPoint
[uit] Verwijzing naar een aanwijzer naar een POINT structuur die de waarde van de registersleutel ontvangt.
Rect
[uit] Verwijzing naar een CRect-variabele die de waarde van de registersleutel ontvangt.
ppData
[uit] Aanwijzer naar gegevens die de waarde van de registersleutel ontvangen.
pBytes
[uit] Aanwijzer naar een variabele met een niet-ondertekend geheel getal. Deze variabele ontvangt de grootte van de buffer waarnaar ppData verwijst.
list
[uit] Verwijzing naar een CObList-variabele die de waarde van de registersleutel ontvangt.
Obj
[uit] Verwijzing naar een CObject-variabele die de waarde van de registersleutel ontvangt.
pObj
[uit] Verwijzing naar een aanwijzer naar een CObject variabele die de waarde van de registersleutel ontvangt.
Retourwaarde
Niet-nul indien geslaagd; anders 0.
Opmerkingen
Read controleert op pszKey als subsleutel van m_hKey.
CSettingsStore::Schrijven
Hiermee schrijft u een waarde naar het register onder de open sleutel.
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);
Parameterwaarden
pszKey
[in] Wijs een tekenreeks aan die de naam van de waarde bevat die moet worden ingesteld.
iVal
[in] Verwijzing naar een geheel getalvariabele die de gegevens bevat die moeten worden opgeslagen.
dwVal
[in] Verwijzing naar een 32-bits variabele met dubbel woord die de gegevens bevat die moeten worden opgeslagen.
pszVal
[in] Wijs een door null beëindigde tekenreeksvariabele aan die de gegevens bevat die moeten worden opgeslagen.
scStringList
[in] Verwijzing naar een CStringList-variabele die de gegevens bevat die moeten worden opgeslagen.
bcArray
[in] Verwijzing naar een bytematrixvariabele die de gegevens bevat die moeten worden opgeslagen.
scArray
[in] Verwijzing naar een tekenreeksmatrixvariabele die de gegevens bevat die moeten worden opgeslagen.
dwcArray
[in] Verwijzing naar een matrixvariabele van 32 bits met dubbele woorden die de gegevens bevat die moeten worden opgeslagen.
wcArray
[in] Verwijzing naar een 16-bits matrixvariabele die de gegevens bevat die moeten worden opgeslagen.
Rect
[in] Verwijzing naar een CRect-variabele die de gegevens bevat die moeten worden opgeslagen.
lpPoint
[in] Verwijzing naar een aanwijzer naar een POINT variabele die de gegevens bevat die moeten worden opgeslagen.
pData-
[in] Wijs een buffer aan die de gegevens bevat die moeten worden opgeslagen.
nBytes
[in] Hiermee geeft u de grootte, in bytes, van de gegevens waarnaar de pData-parameter verwijst.
list
[in] Verwijzing naar een CObList-variabele die de gegevens bevat die moeten worden opgeslagen.
Obj
[in] Verwijzing naar een CObject-variabele die de gegevens bevat die moeten worden opgeslagen.
pObj
[in] Wijs een aanwijzer naar een CObject variabele die de gegevens bevat die moeten worden opgeslagen.
Retourwaarde
WAAR indien geslaagd; anders ONWAAR.
Opmerkingen
Als u naar het register wilt schrijven, moet u bReadOnly instellen op een niet-nulwaarde wanneer u een CSettingsStore-object maakt. Zie CSettingsStore::CSettingsStore voor meer informatie.