| title | CComUnkArray Class | Microsoft Docs | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ms.custom | ||||||||||||||
| ms.date | 11/04/2016 | |||||||||||||
| ms.reviewer | ||||||||||||||
| ms.suite | ||||||||||||||
| ms.technology |
|
|||||||||||||
| ms.tgt_pltfrm | ||||||||||||||
| ms.topic | reference | |||||||||||||
| f1_keywords |
|
|||||||||||||
| dev_langs |
|
|||||||||||||
| helpviewer_keywords |
|
|||||||||||||
| ms.assetid | 5fd4b378-a7b5-4cc1-8866-8ab72a73639e | |||||||||||||
| caps.latest.revision | 17 | |||||||||||||
| author | mikeblome | |||||||||||||
| ms.author | mblome | |||||||||||||
| manager | ghogen | |||||||||||||
| translation.priority.ht |
|
This class stores IUnknown pointers, and is designed to be used as a parameter to the IConnectionPointImpl template class.
template<unsigned int nMaxSize>
class CComUnkArray
nMaxSize
The maximum number of IUnknown pointers that can be held in the static array.
| Name | Description |
|---|---|
| CComUnkArray::CComUnkArray | Constructor. |
| Name | Description |
|---|---|
| CComUnkArray::Add | Call this method to add an IUnknown pointer to the array. |
| CComUnkArray::begin | Returns a pointer to the first IUnknown pointer in the collection. |
| CComUnkArray::end | Returns a pointer to one past the last IUnknown pointer in the collection. |
| CComUnkArray::GetCookie | Call this method to get the cookie associated with a given IUnknown pointer. |
| CComUnkArray::GetUnknown | Call this method to get the IUnknown pointer associated with a given cookie. |
| CComUnkArray::Remove | Call this method to remove an IUnknown pointer from the array. |
CComUnkArray holds a fixed number of IUnknown pointers, each an interface on a connection point. CComUnkArray can be used as a parameter to the IConnectionPointImpl template class. CComUnkArray<1> is a template specialization of CComUnkArray that has been optimized for one connection point.
The CComUnkArray methods begin and end can be used to loop through all connection points (for example, when an event is fired).
See Adding Connection Points to an Object for details on automating creation of connection point proxies.
Note
Note The class CComDynamicUnkArray is used by the Add Class wizard when creating a control which has Connection Points. If you wish to specify the number of Connection Points manually, change the reference from CComDynamicUnkArray to CComUnkArray< n >, where n is the number of connection points required.
Header: atlcom.h
Call this method to add an IUnknown pointer to the array.
DWORD Add(IUnknown* pUnk);
pUnk
Call this method to add an IUnknown pointer to the array.
Returns the cookie associated with the newly added pointer, or 0 if the array is not large enough to contain the new pointer.
Returns a pointer to the beginning of the collection of IUnknown interface pointers.
IUnknown**
begin();
A pointer to an IUnknown interface pointer.
The collection contains pointers to interfaces stored locally as IUnknown. You cast each IUnknown interface to the real interface type and then call through it. You do not need to query for the interface first.
Before using the IUnknown interface, you should check that it is not NULL.
The constructor.
CComUnkArray();
Sets the collection to hold nMaxSize IUnknown pointers, and initializes the pointers to NULL.
Returns a pointer to one past the last IUnknown pointer in the collection.
IUnknown**
end();
A pointer to an IUnknown interface pointer.
The CComUnkArray methods begin and end can be used to loop through all connection points, for example, when an event is fired.
[!code-cppNVC_ATL_COM#44]
Call this method to get the cookie associated with a given IUnknown pointer.
DWORD WINAPI GetCookie(IUnknown** ppFind);
ppFind
The IUnknown pointer for which the associated cookie is required.
Returns the cookie associated with the IUnknown pointer, or 0 if no matching IUnknown pointer is found.
If there is more than one instance of the same IUnknown pointer, this function returns the cookie for the first one.
Call this method to get the IUnknown pointer associated with a given cookie.
IUnknown* WINAPI GetUnknown(DWORD dwCookie);
dwCookie
The cookie for which the associated IUnknown pointer is required.
Returns the IUnknown pointer, or NULL if no matching cookie is found.
Call this method to remove an IUnknown pointer from the array.
BOOL Remove(DWORD dwCookie);
dwCookie
The cookie referencing the IUnknown pointer to be removed from the array.
Returns TRUE if the pointer is removed, FALSE otherwise.