CComGITPtr Sınıfı
Bu sınıf, arabirim işaretçileri ve genel arabirim tablosu (GIT) ile ilgilenmek için yöntemler sağlar.
Sözdizimi
template <class T>
class CComGITPtr
Parametreler
T
GIT'te depolanacak arabirim işaretçisinin türü.
Üyeler
Ortak Oluşturucular
Veri Akışı Adı | Açıklama |
---|---|
CComGITPtr::CComGITPtr | Oluşturucu. |
CComGITPtr::~CComGITPtr | Yok edici. |
Genel Yöntemler
Veri Akışı Adı | Açıklama |
---|---|
CComGITPtr::Attach | Arabirim işaretçisini genel arabirim tablosuna (GIT) kaydetmek için bu yöntemi çağırın. |
CComGITPtr::CopyTo | Arabirimi genel arabirim tablosundan (GIT) geçirilen işaretçiye kopyalamak için bu yöntemi çağırın. |
CComGITPtr::D etach | Arabirimi nesnesinden ilişkilendirmek için bu yöntemi çağırın CComGITPtr . |
CComGITPtr::GetCookie | Nesneden tanımlama bilgisini döndürmek için bu yöntemi çağırın CComGITPtr . |
CComGITPtr::Revoke | Arabirimi genel arabirim tablosundan (GIT) kaldırmak için bu yöntemi çağırın. |
Ortak İşleçler
Veri Akışı Adı | Açıklama |
---|---|
CComGITPtr::operator DWORD | Nesneden CComGITPtr tanımlama bilgisini döndürür. |
CComGITPtr::operator = | Atama işleci. |
Ortak Veri Üyeleri
Veri Akışı Adı | Açıklama |
---|---|
CComGITPtr::m_dwCookie | Kurabiye. |
Açıklamalar
Serbest iş parçacıklı sıralayıcıyı toplayan ve diğer nesnelerden alınan arabirim işaretçilerini kullanması gereken nesneler, arabirimlerin doğru şekilde sıralandığından emin olmak için ek adımlar atmalıdır. Bu genellikle arabirim işaretçilerini GIT'te depolamayı ve her kullanıldığında GIT'ten işaretçiyi almayı içerir. sınıfı CComGITPtr
, GIT'te depolanan arabirim işaretçilerini kullanmanıza yardımcı olmak için sağlanır.
Not
Genel arabirim tablosu özelliği yalnızca DCOM sürüm 1.1 ve üzeri, Windows 98, Service Pack 3 ve üzeri yüklü Windows NT 4.0 ve Windows 2000 ile Windows 95'te kullanılabilir.
Gereksinimler
Üst bilgi: atlbase.h
CComGITPtr::Attach
Arabirim işaretçisini genel arabirim tablosuna (GIT) kaydetmek için bu yöntemi çağırın.
HRESULT Attach(T* p) throw();
HRESULT Attach(DWORD dwCookie) throw();
Parametreler
p
GIT'e eklenecek arabirim işaretçisi.
dwCookie
Arabirim işaretçisini tanımlamak için kullanılan tanımlama bilgisi.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Hata ayıklama derlemelerinde GIT geçerli değilse veya tanımlama bilgisi NULL'a eşitse bir onay hatası oluşur.
CComGITPtr::CComGITPtr
Oluşturucu.
CComGITPtr() throw();
CComGITPtr(T* p);
CComGITPtr(const CComGITPtr& git);
explicit CComGITPtr(DWORD dwCookie) throw();
CComGITPtr(CComGITPtr&& rv);
Parametreler
p
[in] Genel arabirim tablosunda (GIT) depolanacak arabirim işaretçisi.
git
[in] Var olan CComGITPtr
bir nesneye başvuru.
dwCookie
[in] Arabirim işaretçisini tanımlamak için kullanılan bir tanımlama bilgisi.
Rv
[in] Verileri taşımak için kaynak CComGITPtr
nesne.
Açıklamalar
İsteğe bağlı olarak mevcut CComGITPtr
bir nesneyi kullanarak yeni CComGITPtr
bir nesne oluşturur.
Rv kullanan oluşturucu bir taşıma oluşturucudur. Veriler kaynak, rv'den taşınır ve ardından rv temizlenir.
CComGITPtr::~CComGITPtr
Yok edici.
~CComGITPtr() throw();
Açıklamalar
CComGITPtr::Revoke kullanarak arabirimi genel arabirim tablosundan (GIT) kaldırır.
CComGITPtr::CopyTo
Arabirimi genel arabirim tablosundan (GIT) geçirilen işaretçiye kopyalamak için bu yöntemi çağırın.
HRESULT CopyTo(T** pp) const throw();
Parametreler
Pp
Arabirimi almak için işaretçi.
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
GIT arabirimi geçirilen işaretçiye kopyalanır. İşaretçi artık gerekli olmadığında çağıran tarafından serbest bırakılmalıdır.
CComGITPtr::D etach
Arabirimi nesnesinden ilişkilendirmek için bu yöntemi çağırın CComGITPtr
.
DWORD Detach() throw();
Dönüş Değeri
Nesneden CComGITPtr
tanımlama bilgisini döndürür.
Açıklamalar
CComGITPtr::Revoke kullanarak arabirimi GIT'ten kaldırmak çağırana bağlıdır.
CComGITPtr::GetCookie
Nesneden tanımlama bilgisini döndürmek için bu yöntemi çağırın CComGITPtr
.
DWORD GetCookie() const;
Dönüş Değeri
Tanımlama bilgisini döndürür.
Açıklamalar
Tanımlama bilgisi, bir arabirimi ve konumunu tanımlamak için kullanılan bir değişkendir.
CComGITPtr::m_dwCookie
Kurabiye.
DWORD m_dwCookie;
Açıklamalar
Tanımlama bilgisi, bir arabirimi ve konumunu tanımlamak için kullanılan bir üye değişkenidir.
CComGITPtr::operator =
Atama işleci.
CComGITPtr& operator= (T* p);
CComGITPtr& operator= (const CComGITPtr& git);
CComGITPtr& operator= (DWORD dwCookie);
CComGITPtr& operator= (CComGITPtr&& rv);
Parametreler
p
[in] Arabirim işaretçisi.
git
[in] Bir nesneye CComGITPtr
başvuru.
dwCookie
[in] Arabirim işaretçisini tanımlamak için kullanılan bir tanımlama bilgisi.
Rv
[in] CComGITPtr
Verilerinin taşınacak yer.
Dönüş Değeri
Güncelleştirilmiş CComGITPtr
nesneyi döndürür.
Açıklamalar
Var olan bir nesneden veya genel CComGITPtr
arabirim tablosuna yapılan başvurudan bir nesneye yeni bir değer atar.
CComGITPtr::operator DWORD
Nesneyle CComGITPtr
ilişkili tanımlama bilgisini döndürür.
operator DWORD() const;
Açıklamalar
Tanımlama bilgisi, bir arabirimi ve konumunu tanımlamak için kullanılan bir değişkendir.
CComGITPtr::Revoke
Geçerli arabirimi genel arabirim tablosundan (GIT) kaldırmak için bu yöntemi çağırın.
HRESULT Revoke() throw();
Dönüş Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Git'ten arabirimi kaldırır.
Ayrıca bkz.
Serbest İş Parçacıklı Sıralayıcı
Daireler Arasında Arabirimlere Erişme
Genel Arabirim Tablosu Ne Zaman Kullanılır?
Sınıfa Genel Bakış