Classe CComGITPtr

Questa classe fornisce metodi per gestire i puntatori di interfaccia e la tabella dell'interfaccia globale (GIT).

Sintassi

template <class T>
class CComGITPtr

Parametri

T
Tipo del puntatore di interfaccia da archiviare in GIT.

Membri

Costruttori pubblici

Metodi pubblici

Operatori pubblici

Membri dati pubblici

Osservazioni:

Gli oggetti che aggregano il gestore di marshalling a thread libero e devono usare puntatori di interfaccia ottenuti da altri oggetti devono eseguire passaggi aggiuntivi per assicurarsi che le interfacce siano correttamente sottoposto a marshalling. In genere questo comporta l'archiviazione dei puntatori di interfaccia in GIT e il recupero del puntatore dal git ogni volta che viene usato. La classe CComGITPtr viene fornita per facilitare l'uso dei puntatori di interfaccia archiviati in GIT.

Requisiti

Intestazione: atlbase.h

CComGITPtr::Attach

Chiamare questo metodo per registrare il puntatore dell'interfaccia nella tabella dell'interfaccia globale (GIT).

HRESULT Attach(T* p) throw();

HRESULT Attach(DWORD dwCookie) throw();

Parametri

p
Puntatore all'interfaccia da aggiungere a GIT.

dwCookie
Cookie utilizzato per identificare il puntatore dell'interfaccia.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Nelle compilazioni di debug si verificherà un errore di asserzione se GIT non è valido o se il cookie è uguale a NULL.

CComGITPtr::CComGITPtr

Costruttore.

CComGITPtr() throw();
CComGITPtr(T* p);
CComGITPtr(const CComGITPtr& git);
explicit CComGITPtr(DWORD dwCookie) throw();
CComGITPtr(CComGITPtr&& rv);

Parametri

p
[in] Puntatore all'interfaccia da archiviare nella tabella dell'interfaccia globale (GIT).

git
[in] Riferimento a un oggetto esistente CComGITPtr .

dwCookie
[in] Cookie utilizzato per identificare il puntatore dell'interfaccia.

Rv
[in] Oggetto di origine CComGITPtr da cui spostare i dati.

Osservazioni:

Crea un nuovo CComGITPtr oggetto, facoltativamente utilizzando un oggetto esistente CComGITPtr .

Il costruttore che usa rv è un costruttore di spostamento. I dati vengono spostati dall'origine, rv e quindi vengono cancellati.

CComGITPtr::~CComGITPtr

Distruttore.

~CComGITPtr() throw();

Osservazioni:

Rimuove l'interfaccia dalla tabella dell'interfaccia globale (GIT), usando CComGITPtr::Revoke.

CComGITPtr::CopyTo

Chiamare questo metodo per copiare l'interfaccia dalla tabella dell'interfaccia globale (GIT) al puntatore passato.

HRESULT CopyTo(T** pp) const throw();

Parametri

Pp
Puntatore che deve ricevere l'interfaccia.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

L'interfaccia da GIT viene copiata nel puntatore passato. Il puntatore deve essere rilasciato dal chiamante quando non è più necessario.

CComGITPtr::D etach

Chiamare questo metodo per annullare l'associazione dell'interfaccia dall'oggetto CComGITPtr .

DWORD Detach() throw();

Valore restituito

Restituisce il cookie dall'oggetto CComGITPtr .

Osservazioni:

Spetta al chiamante rimuovere l'interfaccia da GIT, usando CComGITPtr::Revoke.

CComGITPtr::GetCookie

Chiamare questo metodo per restituire il cookie dall'oggetto CComGITPtr .

DWORD GetCookie() const;

Valore restituito

Restituisce il cookie.

Osservazioni:

Il cookie è una variabile usata per identificare un'interfaccia e la relativa posizione.

CComGITPtr::m_dwCookie

Cookie.

DWORD m_dwCookie;

Osservazioni:

Il cookie è una variabile membro usata per identificare un'interfaccia e la relativa posizione.

CComGITPtr::operator =

Operatore di assegnazione .

CComGITPtr& operator= (T* p);
CComGITPtr& operator= (const CComGITPtr& git);
CComGITPtr& operator= (DWORD dwCookie);
CComGITPtr& operator= (CComGITPtr&& rv);

Parametri

p
[in] Puntatore a un'interfaccia.

git
[in] Riferimento a un oggetto CComGITPtr.

dwCookie
[in] Cookie utilizzato per identificare il puntatore dell'interfaccia.

Rv
[in] Oggetto CComGITPtr da cui spostare i dati.

Valore restituito

Restituisce l'oggetto aggiornato CComGITPtr .

Osservazioni:

Assegna un nuovo valore a un CComGITPtr oggetto, da un oggetto esistente o da un riferimento a una tabella di interfaccia globale.

CComGITPtr::operator DWORD

Restituisce il cookie associato all'oggetto CComGITPtr .

operator DWORD() const;

Osservazioni:

Il cookie è una variabile usata per identificare un'interfaccia e la relativa posizione.

CComGITPtr::Revoke

Chiamare questo metodo per rimuovere l'interfaccia corrente dalla tabella dell'interfaccia globale (GIT).

HRESULT Revoke() throw();

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Rimuove l'interfaccia da GIT.

Vedi anche

Marshaler threading gratuito
Accesso alle interfacce tra appartamenti
Quando usare la tabella dell'interfaccia globale
Cenni preliminari sulla classe