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
| Ad | Tanım |
|---|---|
| C Ayarlar Store::C Ayarlar Store | Bir CSettingsStore nesne oluşturur. |
Genel Yöntemler
| Ad | Tanım |
|---|---|
| C Ayarlar Store::Close | Açık kayıt defteri anahtarını kapatır. |
| C Ayarlar Store::CreateKey | Belirtilen anahtarı açar veya yoksa oluşturur. |
| C Ayarlar Store::D eleteKey | Belirtilen anahtarı ve tüm alt öğelerini siler. |
| C Ayarlar Store::D eleteValue | Açık anahtarın belirtilen değerini siler. |
| C Ayarlar Store::Open | Belirtilen anahtarı açar. |
| C Ayarlar Store::Read | Belirtilen anahtar değeri için verileri alır. |
| C Ayarlar Store::Write | Kayıt defterine açık anahtarın altında bir değer yazar. |
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
CSettingsStore
Gereksinimler
Üst bilgi: afxsettingsstore.h
C Ayarlar Store::Close
Açık kayıt defteri anahtarını kapatır.
virtual void Close();
Açıklamalar
Varsayılan olarak, bu yöntem C Ayarlar Store Sınıfının yıkıcısından çağrılır.
C Ayarlar Store::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.
İade 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 .
C Ayarlar Store::C Ayarlar Store
Bir CSettngsStore nesnesi oluşturur.
CSettingsStore(
BOOL bAdmin,
BOOL bReadOnly);
Parametreler
b Yönetici
[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
b Yönetici TRUE olarak ayarlanırsa üye m_hKey değişkeni HKEY_LOCAL_MACHINE olarak ayarlanır. b Yönetici 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 .
C Ayarlar Store::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ı.
b Yönetici
[in] Silinecek anahtarın konumunu belirten anahtar.
İade 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.
b Yönetici parametresi sıfırsa, DeleteKey HKEY_CURRENT_USER altında silinecek anahtarı arar. b Yönetici sıfır değilse, DeleteKey HKEY_LOCAL_MACHINE altında silinecek anahtarı arar.
C Ayarlar Store::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.
İade Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
C Ayarlar Store::Open
Bir kayıt defteri anahtarı açar.
virtual BOOL Open(LPCTSTR pszPath);
Parametreler
pszPath
[in] Kayıt defteri anahtarının adı.
İade 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 .
C Ayarlar Store::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.
İade Değeri
Başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Read, alt anahtarı olarak pszKey'i m_hKey denetler.
C Ayarlar Store::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.
İade Değeri
Başarılı olursa DOĞRU; aksi takdirde YANLIŞ.
Açıklamalar
Kayıt defterine yazmak için C Ayarlar Store nesnesi oluşturduğunuzda bReadOnly değerini sıfır olmayan bir değere ayarlamanız gerekir. Daha fazla bilgi için bkz. C Ayarlar Store::C Ayarlar Store.
Ayrıca bkz.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin