Sunucu Kaydı Genel İşlevleri
Bu işlevler, nesne eşlemesinde sunucu nesnelerini kaydetme ve kaydını kaldırma desteği sağlar.
Önemli
Aşağıdaki tabloda listelenen işlevler, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.
Veri Akışı Adı | Açıklama |
---|---|
AtlComModuleRegisterServer | Bu işlev, nesne eşlemesindeki her nesneyi kaydetmek için çağrılır. |
AtlComModuleUnregisterServer | Bu işlev, nesne eşlemesindeki her nesnenin kaydını silmek için çağrılır. |
AtlComModuleRegisterClassObjects | Bu işlev nesne sınıflarını kaydetmek için çağrılır. |
AtlComModuleRevokeClassObjects | Bu işlev, bir COM modülünden sınıf nesnelerini iptal etmek için çağrılır. |
AtlComModuleGetClassObject | Bu işlev sınıf nesnesini almak için çağrılır. |
Gereksinimler
Üst bilgi: atlbase.h
AtlComModuleRegisterServer
Bu işlev, nesne eşlemesindeki her nesneyi kaydetmek için çağrılır.
ATLINLINE ATLAPI AtlComModuleRegisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bRegTypeLib,
const CLSID* pCLSID);
Parametreler
pComModule
COM modülünün işaretçisi.
bRegTypeLib
Tür kitaplığı kaydedilecekse TRUE.
pCLSID
Kaydedilecek nesnenin CLSID'sini gösterir. NULL ise, nesne eşlemesindeki tüm nesneler kaydedilir.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
AtlComModuleRegisterServer
ATL otomatik olarak oluşturulan nesne eşlemesini gösterir ve her nesneyi haritaya kaydeder. pCLSID NULL değilse, yalnızca pCLSID tarafından başvurulan nesne kaydedilir; aksi takdirde tüm nesneler kaydedilir.
Bu işlev CAtlComModule::RegisterServer tarafından çağrılır.
AtlComModuleUnregisterServer
Bu işlev, nesne eşlemesindeki her nesnenin kaydını silmek için çağrılır.
ATLINLINE ATLAPI AtlComModuleUnregisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bUnRegTypeLib,
const CLSID* pCLSID);
Parametreler
pComModule
COM modülünün işaretçisi.
bUnRegTypeLib
Tür kitaplığı kaydedilecekse TRUE.
pCLSID
Kaydedilecek nesnenin CLSID'sini gösterir. NULL ise, nesne eşlemesindeki tüm nesnelerin kaydı silinir.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
AtlComModuleUnregisterServer
ATL nesne eşlemesini gösterir ve haritadaki her bir nesnenin kaydını siler. pCLSID NULL değilse, yalnızca pCLSID tarafından başvuruda bulunılan nesnenin kaydı kaldırılır; aksi takdirde tüm nesnelerin kaydı kaldırılır.
Bu işlev CAtlComModule::UnregisterServer tarafından çağrılır.
AtlComModuleRegisterClassObjects
Bu işlev nesne sınıflarını kaydetmek için çağrılır.
ATLINLINE ATLAPI AtlComModuleRegisterClassObjects(
_ATL_COM_MODULE* pComModule,
DWORD dwClsContext,
DWORD dwFlags);
Parametreler
pComModule
COM modülünün işaretçisi.
dwClsContext
Sınıf nesnesinin çalıştırılacağı bağlamı belirtir. Olası değerler CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER veya CLSCTX_LOCAL_SERVER. Diğer ayrıntılar için bkz . CLSCTX .
dwFlags
Sınıf nesnesine bağlantı türlerini belirler. Olası değerler REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE veya REGCLS_MULTI_SEPARATE. Daha fazla bilgi için bkz . REGCLS .
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Bu yardımcı işlevi CComModule::RegisterClassObjects (ATL 7.0'da kullanımdan kaldırıldı) ve CAtlExeModuleT::RegisterClassObjects tarafından kullanılır.
AtlComModuleRevokeClassObjects
Bu işlev Çalışan Nesne Tablosundan sınıf üretecini kaldırmak için çağrılır.
ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);
Parametreler
pComModule
COM modülünün işaretçisi.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Bu yardımcı işlev CComModule::RevokeClassObjects (ATL 7.0'da kullanımdan kaldırıldı) ve CAtlExeModuleT::RevokeClassObjects tarafından kullanılır.
AtlComModuleGetClassObject
Sınıf üretecini döndürmek için bu işlev çağrılır.
ATLINLINE ATLAPI AtlComModuleGetClassObject(
_ATL_COM_MODULE* pComModule,
REFCLSID rclsid,
REFIID riid,
LPVOID* ppv);
Parametreler
pComModule
COM modülünün işaretçisi.
rclsid
Oluşturulacak nesnenin CLSID'sini.
riid
İstenen arabirimin IID değeri.
ppv
riid tarafından tanımlanan arabirim işaretçisine ilişkin bir işaretçi. Nesne bu arabirimi desteklemiyorsa ppv null olarak ayarlanır.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Bu yardımcı işlev, CComModule::GetClassObject (ATL 7.0'da eski) ve CAtlDllModuleT::GetClassObject tarafından kullanılır.