CComUnkArray osztály

Megjegyzés:

Az aktív sablontár (ATL) továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Ez az osztály a mutatókat tárolja IUnknown , és úgy lett kialakítva, hogy az IConnectionPointImpl sablonosztály paramétereként legyen használva.

Szemantika

template<unsigned int nMaxSize>
class CComUnkArray

Paraméterek

nMaxSize
A statikus tömbben tartható mutatók maximális száma IUnknown .

Tagok

Nyilvános konstruktorok

Név	Description
CComUnkArray::CComUnkArray	Konstruktor.

Nyilvános módszerek

Név	Description
CComUnkArray::Hozzáadás	Hívja meg ezt a metódust, ha mutatót IUnknown szeretne hozzáadni a tömbhöz.
CComUnkArray::begin	Egy mutatót a gyűjtemény első IUnknown mutatójának ad vissza.
CComUnkArray::end	Egy mutatót a gyűjtemény utolsó IUnknown mutatója fölé ad vissza.
CComUnkArray::GetCookie	Hívja meg ezt a metódust, hogy lekérje az adott mutatóhoz társított cookie-t IUnknown .
CComUnkArray::GetUnknown	Hívja meg ezt a metódust egy IUnknown adott cookie-hoz társított mutató lekéréséhez.
CComUnkArray::Remove	Hívja meg ezt a metódust, hogy eltávolítson egy mutatót IUnknown a tömbből.

Megjegyzések

CComUnkArray rögzített számú IUnknown mutatót tartalmaz, amelyek mindegyike egy csatlakozási ponton található interfész. CComUnkArray paraméterként használható az IConnectionPointImpl sablonosztályhoz. CComUnkArray<1> egy olyan sablon specializáció CComUnkArray , amely egy csatlakozási pontra lett optimalizálva.

A CComUnkArraymetódusok az összes csatlakozási ponton (például egy esemény aktiválásakor) végigcsukhatók.

A csatlakozási pont-proxyk létrehozásának automatizálásával kapcsolatos részletekért lásd: Csatlakozási pontok hozzáadása objektumhoz .

Megjegyzés:

Megjegyzés A CComDynamicUnkArray osztályt az Osztály hozzáadása varázsló használja kapcsolati pontokkal rendelkező vezérlőelem létrehozásakor. Ha manuálisan szeretné megadni a csatlakozási pontok számát, módosítsa a hivatkozást n-ről n-re>CComDynamicUnkArrayCComUnkArray<, ahol n a szükséges csatlakozási pontok száma.

Requirements

Fejléc: atlcom.h

CComUnkArray::Hozzáadás

Hívja meg ezt a metódust, ha mutatót IUnknown szeretne hozzáadni a tömbhöz.

DWORD Add(IUnknown* pUnk);

Paraméterek

Punk
Hívja meg ezt a metódust, ha mutatót IUnknown szeretne hozzáadni a tömbhöz.

Visszaadott érték

Az újonnan hozzáadott mutatóhoz társított cookie-t adja vissza, vagy 0 értéket, ha a tömb nem elég nagy ahhoz, hogy az új mutatót tartalmazza.

CComUnkArray::begin

Az illesztőmutatók gyűjteményének IUnknown elejére mutató mutatót ad vissza.

IUnknown**
    begin();

Visszaadott érték

Egy illesztőmutatóra IUnknown mutató mutató.

Megjegyzések

A gyűjtemény a helyileg IUnknowntárolt felületek mutatóit tartalmazza. Minden IUnknown illesztőt a valódi felülettípusra vet, majd meghívja azt. Először nem kell lekérdeznie a felületet.

A felület használata IUnknown előtt ellenőrizze, hogy nem NULL értékű-e.

CComUnkArray::CComUnkArray

A konstruktor.

CComUnkArray();

Megjegyzések

A gyűjteményt úgy állítja be, hogy tartsa a nMaxSizeIUnknown mutatókat, és inicializálja a mutatókat NULL értékre.

CComUnkArray::end

Egy mutatót a gyűjtemény utolsó IUnknown mutatója fölé ad vissza.

IUnknown**
    end();

Visszaadott érték

Egy illesztőmutatóra IUnknown mutató mutató.

Megjegyzések

A CComUnkArray metódusok begin és end felhasználhatók az összes csatlakozási ponton való ciklusra, például egy esemény aktiválásakor.

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

CComUnkArray::GetCookie

Hívja meg ezt a metódust, hogy lekérje az adott mutatóhoz társított cookie-t IUnknown .

DWORD WINAPI GetCookie(IUnknown** ppFind);

Paraméterek

ppFind
Az IUnknown a mutató, amelyhez a társított cookie szükséges.

Visszaadott érték

A mutatóhoz IUnknown társított cookie-t adja vissza, vagy 0 értéket, ha nem található egyező IUnknown mutató.

Megjegyzések

Ha ugyanannak IUnknown a mutatónak több példánya is van, ez a függvény az elsőhöz tartozó cookie-t adja vissza.

CComUnkArray::GetUnknown

Hívja meg ezt a metódust egy IUnknown adott cookie-hoz társított mutató lekéréséhez.

IUnknown* WINAPI GetUnknown(DWORD dwCookie);

Paraméterek

dwCookie
Az a cookie, amelyhez a társított IUnknown mutató szükséges.

Visszaadott érték

IUnknown A mutatót vagy NULL értéket adja vissza, ha nem található egyező cookie.

CComUnkArray::Remove

Hívja meg ezt a metódust, hogy eltávolítson egy mutatót IUnknown a tömbből.

BOOL Remove(DWORD dwCookie);

Paraméterek

dwCookie
A tömbből eltávolítandó mutatóra hivatkozó IUnknown cookie.

Visszaadott érték

Igaz értéket ad vissza, ha a mutató el lett távolítva, hamis.

Lásd még

CComDynamicUnkArray osztály
osztály áttekintése