Condividi tramite


Metodo IConnectionPointContainer::EnumConnectionPoints (ocidl.h)

Crea un oggetto enumeratore per scorrere tutti i punti di connessione supportati nell'oggetto connettibile, un punto di connessione per IID in uscita.

Sintassi

HRESULT EnumConnectionPoints(
  [out] IEnumConnectionPoints **ppEnum
);

Parametri

[out] ppEnum

Puntatore a una variabile di puntatore dell'interfaccia IEnumConnectionPoints che riceve il puntatore al nuovo enumeratore creato.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito Descrizione
S_OK
L'oggetto enumeratore è stato creato correttamente.
E_POINTER
L'indirizzo in ppEnum non è valido. Ad esempio, può essere NULL.

Commenti

Poiché IEnumConnectionPoint enumera i puntatori a IConnectionPoint, il chiamante deve usare IConnectionPoint::GetConnectionInterface per determinare l'identificatore dell'interfaccia in uscita supportata dal punto di connessione.

Note ai chiamanti

Il chiamante è responsabile della chiamata a Release quando l'enumeratore non è più necessario.

Note per gli implementatori

La restituzione di E_NOTIMPL non è consentita in modo specifico perché, ad eccezione delle informazioni sul tipo, non ci sarebbero altri mezzi attraverso cui un chiamante potrebbe trovare gli ID delle interfacce in uscita. Poiché un oggetto connettibile ha in genere un set fisso di interfacce in uscita note, è semplice implementare l'enumeratore sopra una matrice di lunghezza fissa di ID noti in fase di compilazione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione ocidl.h

Vedi anche

IConnectionPointContainer

Ienumconnectionpoints