CAtlModule Sınıfı
Bu sınıf, çeşitli ATL modül sınıfları tarafından kullanılan yöntemler sağlar.
Sözdizimi
class ATL_NO_VTABLE CAtlModule : public _ATL_MODULE
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CAtlModule::CAtlModule | Oluşturucu. |
| CAtlModule::~CAtlModule | Yok edici. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CAtlModule::AddCommonRGSReplacements | ATL Kayıt Defteri Bileşeni (Kayıt Şirketi) değiştirme eşlemesine parametre eklemek için bu yöntemi geçersiz kılın. |
| CAtlModule::AddTermFunc | Modül sonlandırıldığında çağrılacak yeni bir işlev ekler. |
| CAtlModule::GetGITPtr | Genel Arabirim İşaretçisi'ni döndürür. |
| CAtlModule::GetLockCount | Kilit sayısını döndürür. |
| CAtlModule::Lock | Kilit sayısını artırır. |
| CAtlModule::Term | Tüm veri üyelerini serbest bırakır. |
| CAtlModule::Unlock | Kilit sayısını azaltma. |
| CAtlModule::UpdateRegistryFromResourceD | Bir nesneyi kaydetmek veya kaydını kaldırmak için belirtilen kaynakta bulunan betiği çalıştırır. |
| CAtlModule::UpdateRegistryFromResourceDHelper | Bu yöntem, kayıt defteri güncelleştirmesini gerçekleştirmek için tarafından UpdateRegistryFromResourceD çağrılır. |
| CAtlModule::UpdateRegistryFromResourceS | Bir nesneyi kaydetmek veya kaydını kaldırmak için belirtilen kaynakta bulunan betiği çalıştırır. Bu yöntem, ATL Kayıt Defteri Bileşenine statik olarak bağlanır. |
Ortak Veri Üyeleri
| Veri Akışı Adı | Açıklama |
|---|---|
| CAtlModule::m_libid | Geçerli modülün GUID değerini içerir. |
| CAtlModule::m_pGIT | Genel Arabirim Tablosu'na işaretçi. |
Açıklamalar
Bu sınıf sırasıyla DLL uygulamaları, EXE uygulamaları ve Windows hizmetleri için destek sağlamak üzere CAtlDllModuleT Sınıfı, CAtlExeModuleT Sınıfı ve CAtlServiceModuleT Sınıfı tarafından kullanılır.
ATL'deki modüller hakkında daha fazla bilgi için bkz . ATL Modül Sınıfları.
Bu sınıf, ATL'nin önceki sürümlerinde kullanılan eski CComModule Sınıfının yerini alır.
Devralma Hiyerarşisi
CAtlModule
Gereksinimler
Üst bilgi: atlbase.h
CAtlModule::AddCommonRGSReplacements
ATL Kayıt Defteri Bileşeni (Kayıt Şirketi) değiştirme eşlemesine parametre eklemek için bu yöntemi geçersiz kılın.
virtual HRESULT AddCommonRGSReplacements(IRegistrarBase* /* pRegistrar*/) throw() = 0;
Parametreler
pRegistrar
Ayrılmış.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Değiştirilebilir parametreler, kayıt şirketinin istemcisinin çalışma zamanı verilerini belirtmesine olanak sağlar. Bunu yapmak için Kayıt Şirketi, betiğinizdeki değiştirilebilir parametrelerle ilişkili değerleri girdiği bir değiştirme eşlemesi tutar. Kayıt Şirketi bu girişleri çalışma zamanında yapar.
Daha fazla ayrıntı için Değiştirilebilir Parametreleri Kullanma (Kayıt Şirketinin Önişlemcisi) konusuna bakın.
CAtlModule::AddTermFunc
Modül sonlandırıldığında çağrılacak yeni bir işlev ekler.
HRESULT AddTermFunc(_ATL_TERMFUNC* pFunc, DWORD_PTR dw) throw();
Parametreler
pFunc
Eklenecek işlevin işaretçisi.
Dw
İşleve geçirilen kullanıcı tanımlı veriler.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
CAtlModule::CAtlModule
Oluşturucu.
CAtlModule() throw();
Açıklamalar
Veri üyelerini başlatır ve modülün iş parçacığı çevresinde kritik bir bölüm başlatır.
CAtlModule::~CAtlModule
Yok edici.
~CAtlModule() throw();
Açıklamalar
Tüm veri üyelerini serbest bırakır.
CAtlModule::GetGITPtr
Genel Arabirim Tablosuna yönelik bir işaretçi alır.
virtual HRESULT GetGITPtr(IGlobalInterfaceTable** ppGIT) throw();
Parametreler
ppGIT
Genel Arabirim Tablosu'nun işaretçisini alacak değişkenin işaretçisi.
Dönüş Değeri
Başarı durumunda S_OK veya hata durumunda bir hata kodu döndürür. ppGIT null değerine eşitse E_POINTER döndürülür.
Açıklamalar
Genel Arabirim Tablosu nesnesi yoksa oluşturulur ve adresi CAtlModule::m_pGIT üye değişkeninde depolanır.
Hata ayıklama derlemelerinde, ppGIT NULL'a eşitse veya Genel Arabirim Tablosu işaretçisi alınamazsa onay hatası oluşur.
Genel Arabirim Tablosu hakkında bilgi için bkz . IGlobalInterfaceTable .
CAtlModule::GetLockCount
Kilit sayısını döndürür.
virtual LONG GetLockCount() throw();
Dönüş Değeri
Kilit sayısını döndürür. Bu değer tanılama ve hata ayıklama için yararlı olabilir.
CAtlModule::Lock
Kilit sayısını artırır.
virtual LONG Lock() throw();
Dönüş Değeri
Kilit sayısını artırır ve güncelleştirilmiş değeri döndürür. Bu değer tanılama ve hata ayıklama için yararlı olabilir.
CAtlModule::m_libid
Geçerli modülün GUID değerini içerir.
static GUID m_libid;
CAtlModule::m_pGIT
Genel Arabirim Tablosu'na işaretçi.
IGlobalInterfaceTable* m_pGIT;
CAtlModule::Term
Tüm veri üyelerini serbest bırakır.
void Term() throw();
Açıklamalar
Tüm veri üyelerini serbest bırakır. Bu yöntem, yıkıcı tarafından çağrılır.
CAtlModule::Unlock
Kilit sayısını azaltma.
virtual LONG Unlock() throw();
Dönüş Değeri
Kilit sayısını azaltma ve güncelleştirilmiş değeri döndürme. Bu değer tanılama ve hata ayıklama için yararlı olabilir.
CAtlModule::UpdateRegistryFromResourceD
Bir nesneyi kaydetmek veya kaydını kaldırmak için belirtilen kaynakta bulunan betiği çalıştırır.
HRESULT WINAPI UpdateRegistryFromResourceD(
UINT nResID,
BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
HRESULT WINAPI UpdateRegistryFromResourceD(
LPCTSTR lpszRes,
BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
Parametreler
lpszRes
Kaynak adı.
nResID
Kaynak kimliği.
bRegister
Nesnenin kaydedilmesi gerekiyorsa TRUE; FALSE aksi takdirde.
pMapEntries
Betiğin değiştirilebilir parametreleriyle ilişkili değerleri depolayarak değiştirme eşlemesine yönelik bir işaretçi. ATL otomatik olarak %MODULE% kullanır. Değiştirilebilir ek parametreler kullanmak için bkz . CAtlModule::AddCommonRGSReplacements. Aksi takdirde NULL varsayılan değerini kullanın.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
lpszRes veya nResID tarafından belirtilen kaynakta bulunan betiği çalıştırır. bRegister TRUE ise, bu yöntem nesneyi sistem kayıt defterine kaydeder; aksi takdirde nesneyi kayıt defterinden kaldırır.
ATL Kayıt Defteri Bileşenine (Kayıt Şirketi) statik olarak bağlanmak için bkz . CAtlModule::UpdateRegistryFromResourceS.
Bu yöntem CAtlModule::UpdateRegistryFromResourceDHelper ve IRegistrar::ResourceUnregister'ı çağırır.
CAtlModule::UpdateRegistryFromResourceDHelper
Bu yöntem, kayıt defteri güncelleştirmesini gerçekleştirmek için tarafından UpdateRegistryFromResourceD çağrılır.
inline HRESULT WINAPI UpdateRegistryFromResourceDHelper(
LPCOLESTR lpszRes,
BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
Parametreler
lpszRes
Kaynak adı.
bRegister
Nesnenin kaydedilip kaydedilmeyeceğini gösterir.
pMapEntries
Betiğin değiştirilebilir parametreleriyle ilişkili değerleri depolayarak değiştirme eşlemesine yönelik bir işaretçi. ATL otomatik olarak %MODULE% kullanır. Değiştirilebilir ek parametreler kullanmak için bkz . CAtlModule::AddCommonRGSReplacements. Aksi takdirde NULL varsayılan değerini kullanın.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Bu yöntem, CAtlModule::UpdateRegistryFromResourceD uygulamasını sağlar.
CAtlModule::UpdateRegistryFromResourceS
Bir nesneyi kaydetmek veya kaydını kaldırmak için belirtilen kaynakta bulunan betiği çalıştırır. Bu yöntem, ATL Kayıt Defteri Bileşenine statik olarak bağlanır.
HRESULT WINAPI UpdateRegistryFromResourceS(
UINT nResID,
BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
HRESULT WINAPI UpdateRegistryFromResourceS(
LPCTSTR lpszRes,
BOOL bRegister,
struct _ATL_REGMAP_ENTRY* pMapEntries = NULL) throw();
Parametreler
nResID
Kaynak kimliği.
lpszRes
Kaynak adı.
bRegister
Kaynak betiğinin kaydedilip kaydedilmeyeceğini gösterir.
pMapEntries
Betiğin değiştirilebilir parametreleriyle ilişkili değerleri depolayarak değiştirme eşlemesine yönelik bir işaretçi. ATL otomatik olarak %MODULE% kullanır. Değiştirilebilir ek parametreler kullanmak için bkz . CAtlModule::AddCommonRGSReplacements. Aksi takdirde NULL varsayılan değerini kullanın.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
CAtlModule::UpdateRegistryFromResourceD'a benzer ancak CAtlModule::UpdateRegistryFromResourceS ATL Kayıt Defteri Bileşenine (Kayıt Şirketi) statik bir bağlantı oluşturur.
Ayrıca bkz.
_ATL_MODULE
Sınıfa Genel Bakış
Modül Sınıfları
Kayıt Defteri Bileşeni (Kayıt Şirketi)