CComUnkArray-Klasse

Diese Klasse speichert IUnknown Zeiger und wurde als Parameter für die IConnectionPointImpl-Vorlagenklasse verwendet.

Syntax

template<unsigned int nMaxSize>
class CComUnkArray

Parameter

nMaxSize
Die maximale Anzahl von IUnknown Zeigern, die im statischen Array gehalten werden können.

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Hinweise

CComUnkArray enthält eine feste Anzahl von IUnknown Zeigern, jede Schnittstelle auf einem Verbindungspunkt. CComUnkArray kann als Parameter für die IConnectionPointImpl-Vorlagenklasse verwendet werden. CComUnkArray<1> ist eine Vorlagenspezialisierung, die CComUnkArray für einen Verbindungspunkt optimiert wurde.

Die CComUnkArray Methoden beginnen und end können verwendet werden, um alle Verbindungspunkte zu durchlaufen (z. B. wenn ein Ereignis ausgelöst wird).

Weitere Informationen zum Automatisieren der Erstellung von Verbindungspunktproxys finden Sie unter Hinzufügen von Verbindungspunkten zu einem Objekt .

Anforderungen

Kopfzeile: atlcom.h

CComUnkArray::Add

Rufen Sie diese Methode auf, um dem Array einen IUnknown Zeiger hinzuzufügen.

DWORD Add(IUnknown* pUnk);

Parameter

Punk
Rufen Sie diese Methode auf, um dem Array einen IUnknown Zeiger hinzuzufügen.

Rückgabewert

Gibt das cookie zurück, das dem neu hinzugefügten Zeiger zugeordnet ist, oder 0, wenn das Array nicht groß genug ist, um den neuen Zeiger zu enthalten.

CComUnkArray::begin

Gibt einen Zeiger auf den Anfang der Auflistung von IUnknown Schnittstellenzeigern zurück.

IUnknown**
    begin();

Rückgabewert

Ein Zeiger auf einen IUnknown Schnittstellenzeiger.

Hinweise

Die Auflistung enthält Zeiger auf Schnittstellen, die lokal als IUnknown. Sie wandeln jede IUnknown Schnittstelle in den echten Schnittstellentyp um und rufen sie dann durch. Sie müssen zuerst keine Abfrage für die Schnittstelle durchführen.

Bevor Sie die IUnknown Schnittstelle verwenden, sollten Sie überprüfen, ob sie nicht NULL ist.

CComUnkArray::CComUnkArray

Der Konstruktor.

CComUnkArray();

Hinweise

Legt die Auflistung fest, um Zeiger zu halten nMaxSize IUnknown , und initialisiert die Zeiger auf NULL.

CComUnkArray::end

Gibt einen Mauszeiger auf einen Zeiger über den letzten IUnknown Zeiger in der Auflistung zurück.

IUnknown**
    end();

Rückgabewert

Ein Zeiger auf einen IUnknown Schnittstellenzeiger.

Hinweise

Die CComUnkArray Methoden begin und end können verwendet werden, um alle Verbindungspunkte zu durchlaufen, z. B. wenn ein Ereignis ausgelöst wird.

IUnknown** p = m_vec.begin();
while(p != m_vec.end())
{
   // Do something with *p
   p++;
}

CComUnkArray::GetCookie

Rufen Sie diese Methode auf, um das cookie abzurufen, das einem bestimmten Zeiger IUnknown zugeordnet ist.

DWORD WINAPI GetCookie(IUnknown** ppFind);

Parameter

ppFind
Der IUnknown Zeiger, für den das zugehörige Cookie erforderlich ist.

Rückgabewert

Gibt das dem IUnknown Zeiger zugeordnete Cookie zurück oder 0, wenn kein übereinstimmende IUnknown Zeiger gefunden wird.

Hinweise

Wenn mehrere Instanzen desselben IUnknown Zeigers vorhanden sind, gibt diese Funktion das Cookie für die erste zurück.

CComUnkArray::GetUnknown

Rufen Sie diese Methode auf, um den Zeiger abzurufen, der IUnknown einem bestimmten Cookie zugeordnet ist.

IUnknown* WINAPI GetUnknown(DWORD dwCookie);

Parameter

dwCookie
Das Cookie, für das der zugehörige IUnknown Zeiger erforderlich ist.

Rückgabewert

Gibt den IUnknown Zeiger oder NULL zurück, wenn kein übereinstimmende Cookie gefunden wird.

CComUnkArray::Remove

Rufen Sie diese Methode auf, um einen IUnknown Zeiger aus dem Array zu entfernen.

BOOL Remove(DWORD dwCookie);

Parameter

dwCookie
Das Cookie, das auf den Zeiger verweist, der IUnknown aus dem Array entfernt werden soll.

Rückgabewert

Gibt TRUE zurück, wenn der Zeiger entfernt wird, andernfalls FALSE.

Siehe auch

CComDynamicUnkArray-Klasse
Klassenübersicht