Aracılığıyla paylaş


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ış