Klasse CComUnkArray

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Deze klasse slaat IUnknown aanwijzers op en is ontworpen om te worden gebruikt als een parameter voor de sjabloonklasse IConnectionPointImpl .

Syntaxis

template<unsigned int nMaxSize>
class CComUnkArray

Parameterwaarden

nMaxSize
Het maximum aantal IUnknown aanwijzers dat in de statische matrix kan worden opgeslagen.

Leden

Openbare constructors

Naam	Description
CComUnkArray::CComUnkArray	Bouwer.

Openbare methoden

Naam	Description
CComUnkArray::Toevoegen	Roep deze methode aan om een IUnknown aanwijzer toe te voegen aan de matrix.
CComUnkArray::begin	Retourneert een aanwijzer naar de eerste IUnknown aanwijzer in de verzameling.
CComUnkArray::end	Retourneert een aanwijzer naar één na de laatste IUnknown aanwijzer in de verzameling.
CComUnkArray::GetCookie	Roep deze methode aan om de cookie op te halen die is gekoppeld aan een bepaalde IUnknown aanwijzer.
CComUnkArray::GetUnknown	Roep deze methode aan om de IUnknown aanwijzer op te halen die is gekoppeld aan een bepaalde cookie.
CComUnkArray::Remove	Roep deze methode aan om een IUnknown aanwijzer uit de matrix te verwijderen.

Opmerkingen

CComUnkArray bevat een vast aantal IUnknown aanwijzers, elk een interface op een verbindingspunt. CComUnkArray kan worden gebruikt als parameter voor de sjabloonklasse IConnectionPointImpl . CComUnkArray<1> is een sjabloonspecialisatie van CComUnkArray die is geoptimaliseerd voor één verbindingspunt.

De CComUnkArray methoden beginnen en eindigen kunnen worden gebruikt om alle verbindingspunten te doorlopen (bijvoorbeeld wanneer een gebeurtenis wordt geactiveerd).

Zie Verbindingspunten toevoegen aan een object voor meer informatie over het automatiseren van het maken van verbindingspuntproxy's.

Opmerking

Opmerking De klasse CComDynamicUnkArray wordt gebruikt door de wizard Klasse toevoegen bij het maken van een besturingselement met verbindingspunten. Als u het aantal verbindingspunten handmatig wilt opgeven, wijzigt u de verwijzing van CComDynamicUnkArray naar CComUnkArray<n>, waarbij n het aantal vereiste verbindingspunten is.

Requirements

Koptekst: atlcom.h

CComUnkArray::Toevoegen

Roep deze methode aan om een IUnknown aanwijzer toe te voegen aan de matrix.

DWORD Add(IUnknown* pUnk);

Parameterwaarden

Punk
Roep deze methode aan om een IUnknown aanwijzer toe te voegen aan de matrix.

Retourwaarde

Retourneert de cookie die is gekoppeld aan de zojuist toegevoegde aanwijzer of 0 als de matrix niet groot genoeg is om de nieuwe aanwijzer te bevatten.

CComUnkArray::begin

Retourneert een aanwijzer naar het begin van de verzameling IUnknown interfaceaanwijzers.

IUnknown**
    begin();

Retourwaarde

Een aanwijzer naar een IUnknown interfaceaanwijzer.

Opmerkingen

De verzameling bevat aanwijzers naar interfaces die lokaal zijn opgeslagen als IUnknown. U cast elke IUnknown interface naar het echte interfacetype en roept deze vervolgens aan. U hoeft niet eerst een query uit te voeren op de interface.

Voordat u de IUnknown interface gebruikt, moet u controleren of deze niet NULL is.

CComUnkArray::CComUnkArray

De constructor.

CComUnkArray();

Opmerkingen

Hiermee stelt u de verzameling in op aanwijzers nMaxSizeIUnknown en initialiseert u de aanwijzers op NULL.

CComUnkArray::end

Retourneert een aanwijzer naar één na de laatste IUnknown aanwijzer in de verzameling.

IUnknown**
    end();

Retourwaarde

Een aanwijzer naar een IUnknown interfaceaanwijzer.

Opmerkingen

De CComUnkArray methoden begin en end kunnen worden gebruikt om alle verbindingspunten te doorlopen, bijvoorbeeld wanneer een gebeurtenis wordt geactiveerd.

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

CComUnkArray::GetCookie

Roep deze methode aan om de cookie op te halen die is gekoppeld aan een bepaalde IUnknown aanwijzer.

DWORD WINAPI GetCookie(IUnknown** ppFind);

Parameterwaarden

ppFind
De IUnknown aanwijzer waarvoor de bijbehorende cookie is vereist.

Retourwaarde

Retourneert de cookie die is gekoppeld aan de IUnknown aanwijzer of 0 als er geen overeenkomende IUnknown aanwijzer wordt gevonden.

Opmerkingen

Als er meer dan één instantie van dezelfde IUnknown aanwijzer is, retourneert deze functie de cookie voor het eerste exemplaar.

CComUnkArray::GetUnknown

Roep deze methode aan om de IUnknown aanwijzer op te halen die is gekoppeld aan een bepaalde cookie.

IUnknown* WINAPI GetUnknown(DWORD dwCookie);

Parameterwaarden

dwCookie
De cookie waarvoor de bijbehorende IUnknown aanwijzer is vereist.

Retourwaarde

Retourneert de IUnknown aanwijzer of NULL als er geen overeenkomende cookie wordt gevonden.

CComUnkArray::Remove

Roep deze methode aan om een IUnknown aanwijzer uit de matrix te verwijderen.

BOOL Remove(DWORD dwCookie);

Parameterwaarden

dwCookie
De cookie die verwijst naar de IUnknown aanwijzer die uit de matrix moet worden verwijderd.

Retourwaarde

Retourneert TRUE als de aanwijzer wordt verwijderd, anders ONWAAR.

Zie ook

Klasse CComDynamicUnkArray
Overzicht van klassen