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 |
---|---|
|
L'oggetto enumeratore è stato creato correttamente. |
|
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 |