Klasa CComUnkArray

Ta klasa przechowuje IUnknown wskaźniki i jest przeznaczona do użycia jako parametr klasy szablonu I Połączenie ionPointImpl.

Składnia

template<unsigned int nMaxSize>
class CComUnkArray

Parametry

nMaxSize
Maksymalna liczba IUnknown wskaźników, które mogą być przechowywane w tablicy statycznej.

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
CComUnkArray::CComUnkArray	Konstruktor.

Metody publiczne

Nazwa/nazwisko	opis
CComUnkArray::Add	Wywołaj tę metodę IUnknown , aby dodać wskaźnik do tablicy.
CComUnkArray::begin	Zwraca wskaźnik do pierwszego IUnknown wskaźnika w kolekcji.
CComUnkArray::end	Zwraca wskaźnik do jednego obok ostatniego IUnknown wskaźnika w kolekcji.
CComUnkArray::GetCookie	Wywołaj tę metodę, aby pobrać plik cookie skojarzony z danym IUnknown wskaźnikiem.
CComUnkArray::GetUnknown	Wywołaj tę metodę, aby uzyskać IUnknown wskaźnik skojarzony z danym plikiem cookie.
CComUnkArray::Remove	Wywołaj tę metodę IUnknown , aby usunąć wskaźnik z tablicy.

Uwagi

CComUnkArray przechowuje stałą liczbę IUnknown wskaźników, z których każdy jest interfejsem w punkcie połączenia. CComUnkArrayMoże służyć jako parametr do klasy szablonu I Połączenie ionPointImpl. CComUnkArray<1> to specjalizacja szablonu CComUnkArray , która została zoptymalizowana pod kątem jednego punktu połączenia.

CComUnkArray Metody rozpoczynające się i końcowe mogą służyć do pętli przez wszystkie punkty połączenia (na przykład po wyzwoleniu zdarzenia).

Aby uzyskać szczegółowe informacje na temat automatyzowania tworzenia serwerów proxy punktów połączenia, zobacz Dodawanie punktów Połączenie ion do obiektu.

Uwaga

Uwaga Klasa CComDynamicUnkArray jest używana przez kreatora Dodaj klasę podczas tworzenia kontrolki, która ma punkty Połączenie ion. Jeśli chcesz ręcznie określić liczbę punktów Połączenie ion, zmień odwołanie z CComDynamicUnkArray naCComUnkArray< n>, gdzie n to liczba wymaganych punktów połączenia.

Wymagania

Nagłówek: atlcom.h

CComUnkArray::Add

Wywołaj tę metodę IUnknown , aby dodać wskaźnik do tablicy.

DWORD Add(IUnknown* pUnk);

Parametry

Punk
Wywołaj tę metodę IUnknown , aby dodać wskaźnik do tablicy.

Wartość zwracana

Zwraca plik cookie skojarzony z nowo dodanym wskaźnikiem lub 0, jeśli tablica nie jest wystarczająco duża, aby zawierać nowy wskaźnik.

CComUnkArray::begin

Zwraca wskaźnik na początku kolekcji wskaźników interfejsu IUnknown .

IUnknown**
    begin();

Wartość zwracana

Wskaźnik do wskaźnika interfejsu IUnknown .

Uwagi

Kolekcja zawiera wskaźniki do interfejsów przechowywanych lokalnie jako IUnknown. Każdy IUnknown interfejs jest rzutowy do rzeczywistego typu interfejsu, a następnie wywołuje go. Najpierw nie trzeba wykonywać zapytań dotyczących interfejsu.

Przed użyciem interfejsu IUnknown należy sprawdzić, czy nie ma wartości NULL.

CComUnkArray::CComUnkArray

Konstruktor.

CComUnkArray();

Uwagi

Ustawia kolekcję do przechowywania nMaxSizeIUnknown wskaźników i inicjuje wskaźniki na wartość NULL.

CComUnkArray::end

Zwraca wskaźnik do jednego obok ostatniego IUnknown wskaźnika w kolekcji.

IUnknown**
    end();

Wartość zwracana

Wskaźnik do wskaźnika interfejsu IUnknown .

Uwagi

Metody CComUnkArraybegin i end mogą służyć do pętli przez wszystkie punkty połączenia, na przykład po uruchomieniu zdarzenia.

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

CComUnkArray::GetCookie

Wywołaj tę metodę, aby pobrać plik cookie skojarzony z danym IUnknown wskaźnikiem.

DWORD WINAPI GetCookie(IUnknown** ppFind);

Parametry

ppFind
Wskaźnik IUnknown , dla którego jest wymagany skojarzony plik cookie.

Wartość zwracana

Zwraca plik cookie skojarzony ze wskaźnikiem IUnknown lub 0, jeśli nie zostanie znaleziony pasujący IUnknown wskaźnik.

Uwagi

Jeśli istnieje więcej niż jedno wystąpienie tego samego IUnknown wskaźnika, ta funkcja zwraca plik cookie dla pierwszego wystąpienia.

CComUnkArray::GetUnknown

Wywołaj tę metodę, aby uzyskać IUnknown wskaźnik skojarzony z danym plikiem cookie.

IUnknown* WINAPI GetUnknown(DWORD dwCookie);

Parametry

dwCookie
Plik cookie, dla którego jest wymagany skojarzony IUnknown wskaźnik.

Wartość zwracana

IUnknown Zwraca wskaźnik lub wartość NULL, jeśli nie znaleziono pasującego pliku cookie.

CComUnkArray::Remove

Wywołaj tę metodę IUnknown , aby usunąć wskaźnik z tablicy.

BOOL Remove(DWORD dwCookie);

Parametry

dwCookie
Plik cookie odwołujący IUnknown się do wskaźnika, który ma zostać usunięty z tablicy.

Wartość zwracana

Zwraca wartość TRUE, jeśli wskaźnik zostanie usunięty, w przeciwnym razie wartość FALSE.

Zobacz też

Klasa CComDynamicUnkArray
Omówienie klasy