CComGITPtr – třída
Tato třída poskytuje metody pro práci s ukazateli rozhraní a tabulkou globálního rozhraní (GIT).
Syntaxe
template <class T>
class CComGITPtr
Parametry
T
Typ ukazatele rozhraní, který se má uložit v GITu.
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CComGITPtr::CComGITPtr | Konstruktor |
| CComGITPtr::~CComGITPtr | Destruktor. |
Veřejné metody
| Název | Popis |
|---|---|
| CComGITPtr::Attach | Voláním této metody zaregistrujte ukazatel rozhraní v globální tabulce rozhraní (GIT). |
| CComGITPtr::CopyTo | Voláním této metody zkopírujte rozhraní z tabulky globálního rozhraní (GIT) na předaný ukazatel. |
| CComGITPtr::D etach | Voláním této metody zrušte přidružení rozhraní od objektu CComGITPtr . |
| CComGITPtr::GetCookie | Voláním této metody vrátí soubor cookie z objektu CComGITPtr . |
| CComGITPtr::Revoke | Voláním této metody odeberete rozhraní z tabulky globálního rozhraní (GIT). |
Veřejné operátory
| Název | Popis |
|---|---|
| CComGITPtr::operator DWORD | Vrátí soubor cookie z objektu CComGITPtr . |
| CComGITPtr::operator = | Operátor přiřazení. |
Veřejné datové členy
| Název | Popis |
|---|---|
| CComGITPtr::m_dwCookie | Soubor cookie. |
Poznámky
Objekty, které agregují volný zařazovač vláken a potřebují používat ukazatele rozhraní získané z jiných objektů, musí provést další kroky, aby bylo zajištěno správné zařazování rozhraní. Obvykle se to týká uložení ukazatelů rozhraní do GITu a získání ukazatele z GITu při každém použití. Tato třída CComGITPtr vám pomůže používat ukazatele rozhraní uložené v GITu.
Poznámka:
Nástroj tabulky globálního rozhraní je k dispozici pouze ve Windows 95 s DCOM verze 1.1 a novější, Windows 98, systém Windows NT 4.0 s aktualizací Service Pack 3 a novější a Windows 2000.
Požadavky
Hlavička: atlbase.h
CComGITPtr::Attach
Voláním této metody zaregistrujte ukazatel rozhraní v globální tabulce rozhraní (GIT).
HRESULT Attach(T* p) throw();
HRESULT Attach(DWORD dwCookie) throw();
Parametry
p
Ukazatel rozhraní, který se má přidat do GITu.
dwCookie
Soubor cookie použitý k identifikaci ukazatele rozhraní.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
V buildech ladění dojde k chybě kontrolního výrazu, pokud git není platný nebo pokud se soubor cookie rovná hodnotě NULL.
CComGITPtr::CComGITPtr
Konstruktor
CComGITPtr() throw();
CComGITPtr(T* p);
CComGITPtr(const CComGITPtr& git);
explicit CComGITPtr(DWORD dwCookie) throw();
CComGITPtr(CComGITPtr&& rv);
Parametry
p
[v] Ukazatel rozhraní, který se má uložit v globální tabulce rozhraní (GIT).
git
[v] Odkaz na existující CComGITPtr objekt.
dwCookie
[v] Soubor cookie sloužící k identifikaci ukazatele rozhraní.
Rv
[v] Zdrojový CComGITPtr objekt pro přesun dat.
Poznámky
Vytvoří nový CComGITPtr objekt, volitelně pomocí existujícího CComGITPtr objektu.
Konstruktor využívající rv je konstruktor přesunutí. Data se přesunou ze zdroje, rv a pak se vymažou.
CComGITPtr::~CComGITPtr
Destruktor.
~CComGITPtr() throw();
Poznámky
Odebere rozhraní z tabulky globálního rozhraní (GIT) pomocí CComGITPtr::Revoke.
CComGITPtr::CopyTo
Voláním této metody zkopírujte rozhraní z tabulky globálního rozhraní (GIT) na předaný ukazatel.
HRESULT CopyTo(T** pp) const throw();
Parametry
Pp
Ukazatel, který má rozhraní přijmout.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
Rozhraní z GITu se zkopíruje do předaného ukazatele. Ukazatel musí volající uvolnit, pokud už ho nepotřebujete.
CComGITPtr::D etach
Voláním této metody zrušte přidružení rozhraní od objektu CComGITPtr .
DWORD Detach() throw();
Návratová hodnota
Vrátí soubor cookie z objektu CComGITPtr .
Poznámky
Volajícímu stačí odebrat rozhraní z GITu pomocí CComGITPtr::Revoke.
CComGITPtr::GetCookie
Voláním této metody vrátí soubor cookie z objektu CComGITPtr .
DWORD GetCookie() const;
Návratová hodnota
Vrátí soubor cookie.
Poznámky
Soubor cookie je proměnná sloužící k identifikaci rozhraní a jeho umístění.
CComGITPtr::m_dwCookie
Soubor cookie.
DWORD m_dwCookie;
Poznámky
Soubor cookie je členová proměnná používaná k identifikaci rozhraní a jeho umístění.
CComGITPtr::operator =
Operátor přiřazení.
CComGITPtr& operator= (T* p);
CComGITPtr& operator= (const CComGITPtr& git);
CComGITPtr& operator= (DWORD dwCookie);
CComGITPtr& operator= (CComGITPtr&& rv);
Parametry
p
[v] Ukazatel na rozhraní.
git
[v] Odkaz na CComGITPtr objekt.
dwCookie
[v] Soubor cookie sloužící k identifikaci ukazatele rozhraní.
Rv
[v] Přesun CComGITPtr dat z.
Návratová hodnota
Vrátí aktualizovaný CComGITPtr objekt.
Poznámky
Přiřadí k objektu CComGITPtr novou hodnotu, a to buď z existujícího objektu, nebo z odkazu na tabulku globálního rozhraní.
CComGITPtr::operator DWORD
Vrátí soubor cookie přidružený k objektu CComGITPtr .
operator DWORD() const;
Poznámky
Soubor cookie je proměnná sloužící k identifikaci rozhraní a jeho umístění.
CComGITPtr::Revoke
Voláním této metody odeberete aktuální rozhraní z tabulky globálního rozhraní (GIT).
HRESULT Revoke() throw();
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
Odebere rozhraní z GITu.
Viz také
Free Threaded Marshaler
Přístup k rozhraním napříč apartmány
Kdy použít tabulku globálního rozhraní
Přehled třídy