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

Jméno	popis
CComGITPtr::CComGITPtr	Konstruktor
CComGITPtr::~CComGITPtr	Destruktor.

Veřejné metody

Jméno	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

Jméno	popis
CComGITPtr::operator DWORD	Vrátí soubor cookie z objektu CComGITPtr .
CComGITPtr::operator =	Operátor přiřazení.

Veřejné datové členy

Jméno	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í.

Vrácená 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

Stran
Ukazatel, který má rozhraní přijmout.

Vrácená 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();

Vrácená 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;

Vrácená 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.

Vrácená 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();

Vrácená 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