Kayıt Defteri ve TypeLib Genel İşlevleri
Bu işlevler, bir tür kitaplığını yükleme ve kaydetme desteği sağlar.
Önemli
Aşağıdaki tablolarda listelenen işlevler, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.
| Ad | Tanım |
|---|---|
| AfxRegCreateKey | Belirtilen kayıt defteri anahtarını oluşturur. |
| AfxRegDeleteKey | Belirtilen kayıt defteri anahtarını siler. |
| AfxRegisterPreviewHandler | Önizleme işleyicisini kaydetmek için bir yardımcı. |
| AfxUnregisterPreviewHandler | Önizleme işleyicisi kaydını kaldıran bir yardımcı. |
| AtlRegisterTypeLib | Tür kitaplığını kaydetmek için bu işlev çağrılır. |
| AtlUnRegisterTypeLib | Bu işlev, tür kitaplığının kaydını kaldırmak için çağrılır |
| AfxRegOpenKey | Belirtilen kayıt defteri anahtarını açar. |
| AfxRegOpenKeyEx | Belirtilen kayıt defteri anahtarını açar. |
| AtlLoadTypeLib | Tür kitaplığını yüklemek için bu işlev çağrılır. |
| AtlUpdateRegistryFromResourceD | Sağlanan kaynaktan kayıt defterini güncelleştirmek için bu işlev çağrılır. |
| RegistryDataExchange | Bu işlev, sistem kayıt defterinden okumak veya ona yazmak için kullanılır. Kayıt Defteri Veri Değişimi Makroları tarafından çağrılır. |
Bu işlevler, programın bilgileri depolamak için kayıt defterinde hangi düğümü kullandığını denetler.
| Ad | Tanım |
|---|---|
| AtlGetPerUserRegistration | Uygulamanın kayıt defteri erişimini HKEY_CURRENT_USER ( HKCU) düğümüne yönlendirip yönlendirmediğini alır. |
| AtlSetPerUserRegistration | Uygulamanın kayıt defteri erişimini HKEY_CURRENT_USER ( HKCU) düğümüne yeniden yönlendirip yönlendirmeyeceğini ayarlar. |
Gereksinimler
Üst bilgi: atlbase.h
AtlGetPerUserRegistration
Uygulamanın kayıt defteri erişimini HKEY_CURRENT_USER (HKCU) düğümüne yönlendirip yönlendirmediğini belirlemek için bu işlevi kullanın.
Sözdizimi
ATLINLINE ATLAPI AtlGetPerUserRegistration(bool* pEnabled);
Parametreler
pEnabled
[out] DOĞRU, kayıt defteri bilgilerinin HKCU düğümüne yönlendirildiğini gösterir; YANLIŞ, uygulamanın kayıt defteri bilgilerini varsayılan düğüme yazdığını gösterir. Varsayılan düğüm HKEY_CLASSES_ROOT (HKCR) şeklindedir.
İade Değeri
Yöntemin başarılı olup olmadığını S_OK, aksi takdirde bir hata oluşursa HRESULT hata kodu.
Açıklamalar
Kayıt defteri yeniden yönlendirmesi varsayılan olarak etkin değildir. Bu seçeneği etkinleştirirseniz, kayıt defteri erişimi HKEY_CURRENT_USER\Software\Classes'a yönlendirilir.
Yeniden yönlendirme genel değil. Bu kayıt defteri yeniden yönlendirmeden yalnızca MFC ve ATL çerçeveleri etkilenir.
Gereksinimler
Üst bilgi: atlbase.h
AfxRegCreateKey
Belirtilen kayıt defteri anahtarını oluşturur.
Sözdizimi
LONG AFXAPI AfxRegCreateKey(HKEY hKey, LPCTSTR lpSubKey, PHKEY phkResult, CAtlTransactionManager* pTM = NULL);
Parametreler
Hkey
Açık kayıt defteri anahtarının tanıtıcısı.
lpSubKey
Bu işlevin açtığı veya oluşturduğu anahtarın adı.
phkResult
Açılan veya oluşturulan anahtara tanıtıcı alan bir değişken işaretçisi.
pTM
Nesne CAtlTransactionManager işaretçisi.
İade Değeri
İşlev başarılı olursa, dönüş değeri ERROR_SUCCESS. İşlev başarısız olursa, dönüş değeri Winerror.h dosyasında tanımlanan sıfır olmayan bir hata kodudur.
Gereksinimler
Üst bilgi: afxpriv.h
AfxRegDeleteKey
Belirtilen kayıt defteri anahtarını siler.
Sözdizimi
LONG AFXAPI AfxRegDeleteKey(HKEY hKey, LPCTSTR lpSubKey, CAtlTransactionManager* pTM = NULL);
Parametreler
Hkey
Açık kayıt defteri anahtarının tanıtıcısı.
lpSubKey
Silinecek anahtarın adı.
pTM
Nesne CAtlTransactionManager işaretçisi.
İade Değeri
İşlev başarılı olursa, dönüş değeri ERROR_SUCCESS. İşlev başarısız olursa, dönüş değeri Winerror.h dosyasında tanımlanan sıfır olmayan bir hata kodudur.
Gereksinimler
Üst bilgi: afxpriv.h
Önizleme işleyicisini kaydetmek için bir yardımcı.
Sözdizimi
BOOL AFXAPI AfxRegisterPreviewHandler(LPCTSTR lpszCLSID, LPCTSTR lpszShortTypeName, LPCTSTR lpszFilterExt);
Parametreler
lpszCLSID
İşleyicinin CLSID'sini belirtir.
lpszShortTypeName
İşleyicinin ProgID değerini belirtir.
lpszFilterExt
Bu işleyiciyle kaydedilen dosya uzantısını belirtir.
Gereksinimler
Üst bilgi: afxdisp.h
AtlRegisterTypeLib
Tür kitaplığını kaydetmek için bu işlev çağrılır.
ATLAPI AtlRegisterTypeLib(HINSTANCE hInstTypeLib, LPCOLESTR lpszIndex);
Parametreler
hInstTypeLib
Modül örneğinin tanıtıcısı.
lpszIndex
"\\N" biçiminde dize; burada N, tür kitaplığı kaynağının tamsayı dizinidir. Dizin gerekli değilse NULL olabilir.
İade Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Bu yardımcı işlevi AtlComModuleUnregisterServer ve CAtlComModule::RegisterTypeLib tarafından kullanılır.
Gereksinimler
Üst bilgi: atlbase.h
AfxRegOpenKey
Belirtilen kayıt defteri anahtarını açar.
Sözdizimi
LONG AFXAPI AfxRegOpenKey(HKEY hKey, LPCTSTR lpSubKey, PHKEY phkResult, CAtlTransactionManager* pTM = NULL);
Parametreler
Hkey
Açık kayıt defteri anahtarının tanıtıcısı.
lpSubKey
Bu işlevin açtığı veya oluşturduğu anahtarın adı.
phkResult
Oluşturulan anahtarın tanıtıcısını alan bir değişken işaretçisi.
pTM
Nesne CAtlTransactionManager işaretçisi.
İade Değeri
İşlev başarılı olursa, dönüş değeri ERROR_SUCCESS. İşlev başarısız olursa, dönüş değeri Winerror.h dosyasında tanımlanan sıfır olmayan bir hata kodudur.
Gereksinimler
Üst bilgi: afxpriv.h
AfxRegOpenKeyEx
Belirtilen kayıt defteri anahtarını açar.
Sözdizimi
LONG AFXAPI AfxRegOpenKeyEx(HKEY hKey, LPCTSTR lpSubKey, DWORD ulOptions, REGSAM samDesired, PHKEY phkResult, CAtlTransactionManager* pTM = NULL);
Parametreler
Hkey
Açık kayıt defteri anahtarının tanıtıcısı.
lpSubKey
Bu işlevin açtığı veya oluşturduğu anahtarın adı.
ulOptions
Bu parametre ayrılmıştır ve sıfır olmalıdır.
samDesired
Anahtar için istenen erişim haklarını belirten bir maske.
phkResult
Açık anahtarın tanıtıcısını alan bir değişken işaretçisi.
pTM
Nesne CAtlTransactionManager işaretçisi.
İade Değeri
İşlev başarılı olursa, dönüş değeri ERROR_SUCCESS. İşlev başarısız olursa, dönüş değeri Winerror.h dosyasında tanımlanan sıfır olmayan bir hata kodudur.
Gereksinimler
Üst bilgi: afxpriv.h
AfxUnregisterPreviewHandler
Önizleme işleyicisi kaydını kaldıran bir yardımcı.
Sözdizimi
BOOL AFXAPI AfxUnRegisterPreviewHandler(LPCTSTR lpszCLSID);
Parametreler
lpszCLSID
Kaydedilecek işleyicinin CLSID'sini belirtir.
Gereksinimler
Üst bilgi: afxdisp.h
AtlSetPerUserRegistration
Uygulamanın kayıt defteri erişimini HKEY_CURRENT_USER (HKCU) düğümüne yeniden yönlendirip yönlendirmeyeceğini ayarlar.
Sözdizimi
ATLINLINE ATLAPI AtlSetPerUserRegistration(bool bEnable);
Parametreler
bEnable
[in] DOĞRU, kayıt defteri bilgilerinin HKCU düğümüne yönlendirildiğini gösterir; YANLIŞ, uygulamanın kayıt defteri bilgilerini varsayılan düğüme yazdığını gösterir. Varsayılan düğüm HKEY_CLASSES_ROOT (HKCR) şeklindedir.
İade Değeri
Yöntemin başarılı olup olmadığını S_OK, aksi takdirde bir hata oluşursa HRESULT hata kodu.
Açıklamalar
Kayıt defteri yeniden yönlendirmesi varsayılan olarak etkin değildir. Bu seçeneği etkinleştirirseniz, kayıt defteri erişimi HKEY_CURRENT_USER\Software\Classes'a yönlendirilir.
Yeniden yönlendirme genel değil. Bu kayıt defteri yeniden yönlendirmeden yalnızca MFC ve ATL çerçeveleri etkilenir.
Gereksinimler
Üst bilgi: atlbase.h
AtlUnRegisterTypeLib
Tür kitaplığının kaydını silmek için bu işlev çağrılır.
Sözdizimi
ATLAPI AtlUnRegisterTypeLib(
HINSTANCE hInstTypeLib,
LPCOLESTR lpszIndex);
Parametreler
hInstTypeLib
Modül örneğinin tanıtıcısı.
lpszIndex
"\\N" biçiminde dize; burada N, tür kitaplığı kaynağının tamsayı dizinidir. Dizin gerekli değilse NULL olabilir.
İade Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Bu yardımcı işlevi CAtlComModule::UnRegisterTypeLib ve AtlComModuleUnregisterServer tarafından kullanılır.
Gereksinimler
Üst bilgi: atlbase.h
AtlLoadTypeLib
Tür kitaplığını yüklemek için bu işlev çağrılır.
Sözdizimi
ATLINLINE ATLAPI AtlLoadTypeLib(
HINSTANCE hInstTypeLib,
LPCOLESTR lpszIndex,
BSTR* pbstrPath,
ITypeLib** ppTypeLib);
Parametreler
hInstTypeLib
Tür kitaplığıyla ilişkilendirilmiş modülün tanıtıcısı.
lpszIndex
"\\N" biçiminde dize; burada N, tür kitaplığı kaynağının tamsayı dizinidir. Dizin gerekli değilse NULL olabilir.
pbstrPath
Başarılı bir dönüşte, tür kitaplığıyla ilişkilendirilmiş modülün tam yolunu içerir.
ppTypeLib
Başarılı dönüşte, yüklenen tür kitaplığına yönelik bir işaretçiyi içerir.
İade Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Bu yardımcı işlev AtlRegisterTypeLib ve AtlUnRegisterTypeLib tarafından kullanılır.
AtlUpdateRegistryFromResourceD
Bu işlev Visual Studio 2013'te kullanım dışı bırakıldı ve Visual Studio 2015'te kaldırıldı.
<removed>
RegistryDataExchange
Bu işlev, sistem kayıt defterinden okumak veya ona yazmak için kullanılır.
Sözdizimi
HRESULT RegistryDataExchange(
T* pT,
enum RDXOperations rdxOp,
void* pItem = NULL);
Parametreler
Pt
Geçerli nesnenin işaretçisi.
rdxOp
İşlevin hangi işlemi gerçekleştirmesi gerektiğini gösteren bir numaralandırma değeri. İzin verilen değerler için Açıklamalar bölümündeki tabloya bakın.
pItem
Kayıt defterinden okunacak veya yazılacak verilerin işaretçisi. Veriler, kayıt defterinden silinecek bir anahtarı da temsil edebilir. Varsayılan değer NULL'dir.
İade Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Makrolar BEGIN_RDX_MAP ve END_RDX_MAP öğesini çağıran RegistryDataExchangebir işleve genişletir.
İşlevin gerçekleştirmesi gereken işlemi gösteren olası numaralandırma değerleri aşağıdaki tabloda gösterilmiştir:
| Numaralandırma değeri | İşlem |
|---|---|
| eReadFromReg | Kayıt defterinden verileri okuma. |
| eWriteToReg | Kayıt defterine veri yazma. |
| eDeleteFromReg | Anahtarı kayıt defterinden silin. |
Gereksinimler
Üst bilgi: atlbase.h
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