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.