CComUnkArray, classe

Cette classe stocke IUnknown les pointeurs et est conçue pour être utilisée comme paramètre pour la classe de modèle IConnectionPointImpl .

Syntaxe

template<unsigned int nMaxSize>
class CComUnkArray

Paramètres

nMaxSize
Nombre maximal de IUnknown pointeurs pouvant être conservés dans le tableau statique.

Membres

Constructeurs publics

Nom	Description
CComUnkArray ::CComUnkArray	Constructeur.

Méthodes publiques

Nom	Description
CComUnkArray ::Add	Appelez cette méthode pour ajouter un IUnknown pointeur au tableau.
CComUnkArray ::begin	Retourne un pointeur vers le premier IUnknown pointeur de la collection.
CComUnkArray ::end	Retourne un pointeur vers un pointeur au-delà du dernier IUnknown pointeur de la collection.
CComUnkArray ::GetCookie	Appelez cette méthode pour obtenir le cookie associé à un pointeur donné IUnknown .
CComUnkArray ::GetUnknown	Appelez cette méthode pour obtenir le IUnknown pointeur associé à un cookie donné.
CComUnkArray ::Remove	Appelez cette méthode pour supprimer un IUnknown pointeur du tableau.

Notes

CComUnkArray contient un nombre fixe de pointeurs, chaque interface sur un point de IUnknown connexion. CComUnkArray peut être utilisé comme paramètre pour la classe de modèle IConnectionPointImpl . CComUnkArray<1> est une spécialisation de modèle qui a été optimisée pour un point de CComUnkArray connexion.

Les CComUnkArray méthodes de début et de fin peuvent être utilisées pour parcourir tous les points de connexion (par exemple, lorsqu’un événement est déclenché).

Pour plus d’informations sur l’automatisation de la création de proxys de point de connexion, consultez Ajout de points de connexion à un objet .

Remarque

Notez que la classe CComDynamicUnkArray est utilisée par l’Assistant Ajouter une classe lors de la création d’un contrôle avec des points de connexion. Si vous souhaitez spécifier manuellement le nombre de points de connexion, remplacez la référence par CComDynamicUnkArray CComUnkArray< n>, où n correspond au nombre de points de connexion requis.

Spécifications

En-tête : atlcom.h

CComUnkArray ::Add

Appelez cette méthode pour ajouter un IUnknown pointeur au tableau.

DWORD Add(IUnknown* pUnk);

Paramètres

punk
Appelez cette méthode pour ajouter un IUnknown pointeur au tableau.

Valeur de retour

Retourne le cookie associé au pointeur nouvellement ajouté, ou 0 si le tableau n’est pas suffisamment grand pour contenir le nouveau pointeur.

CComUnkArray ::begin

Retourne un pointeur au début de la collection de pointeurs d’interface IUnknown .

IUnknown**
    begin();

Valeur de retour

Pointeur vers un pointeur d’interface IUnknown .

Notes

La collection contient des pointeurs vers des interfaces stockées localement en tant que IUnknown. Vous castez chaque IUnknown interface en type d’interface réel, puis appelez-la. Vous n’avez pas besoin d’interroger l’interface en premier.

Avant d’utiliser l’interface IUnknown , vous devez vérifier qu’elle n’est pas NULL.

CComUnkArray ::CComUnkArray

Constructeur .

CComUnkArray();

Notes

Définit la collection pour contenir nMaxSize IUnknown des pointeurs et initialise les pointeurs sur NULL.

CComUnkArray ::end

Retourne un pointeur vers un pointeur au-delà du dernier IUnknown pointeur de la collection.

IUnknown**
    end();

Valeur de retour

Pointeur vers un pointeur d’interface IUnknown .

Notes

Les CComUnkArray méthodes begin et end peuvent être utilisées pour parcourir tous les points de connexion, par exemple lorsqu’un événement est déclenché.

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

CComUnkArray ::GetCookie

Appelez cette méthode pour obtenir le cookie associé à un pointeur donné IUnknown .

DWORD WINAPI GetCookie(IUnknown** ppFind);

Paramètres

ppFind
Pointeur IUnknown pour lequel le cookie associé est requis.

Valeur de retour

Retourne le cookie associé au IUnknown pointeur, ou 0 si aucun pointeur correspondant IUnknown n’est trouvé.

Notes

S’il existe plusieurs instances du même IUnknown pointeur, cette fonction retourne le cookie pour le premier.

CComUnkArray ::GetUnknown

Appelez cette méthode pour obtenir le IUnknown pointeur associé à un cookie donné.

IUnknown* WINAPI GetUnknown(DWORD dwCookie);

Paramètres

dwCookie
Cookie pour lequel le pointeur associé IUnknown est requis.

Valeur de retour

Retourne le IUnknown pointeur ou NULL si aucun cookie correspondant n’est trouvé.

CComUnkArray ::Remove

Appelez cette méthode pour supprimer un IUnknown pointeur du tableau.

BOOL Remove(DWORD dwCookie);

Paramètres

dwCookie
Cookie référençant le IUnknown pointeur à supprimer du tableau.

Valeur de retour

Retourne TRUE si le pointeur est supprimé, FALSE dans le cas contraire.

Voir aussi

CComDynamicUnkArray, classe
Vue d’ensemble de la classe