Metodo IConnectionPointContainer::FindConnectionPoint (ocidl.h)

  • Articolo

Restituisce un puntatore all'interfaccia IConnectionPoint di un punto di connessione per un IID specificato, se tale IID descrive un'interfaccia in uscita supportata.

Sintassi

HRESULT FindConnectionPoint(
  [in]  REFIID           riid,
  [out] IConnectionPoint **ppCP
);

Parametri

[in] riid

Identificatore dell'interfaccia in uscita il cui oggetto punto di connessione viene richiesto.

[out] ppCP

Indirizzo di una variabile del puntatore dell'interfaccia IConnectionPoint che riceve il puntatore al punto di connessione che supporta l'interfaccia riid . Se si verifica un errore, l'implementazione imposta il valore su NULL.

Valore restituito

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

Codice restituito Descrizione
S_OK
 Metodo completato correttamente.
E_POINTER
 L'indirizzo in ppCP non è valido. Ad esempio, può essere NULL.
CONNECT_E_NOCONNECTION
 Questo oggetto connettibile non supporta l'interfaccia in uscita specificata da riid.

Commenti

Questo metodo è l'equivalente queryInterface per le interfacce in uscita di un oggetto, in cui l'interfaccia in uscita viene specificata con riid e dove il puntatore dell'interfaccia restituito è sempre quello di un punto di connessione.

Note ai chiamanti

Se la chiamata ha esito positivo, il chiamante è responsabile del rilascio del punto di connessione chiamando Release quando il punto di connessione non è più necessario.

Note per gli implementatori

E_NOTIMPL non è consentito come valore restituito per questo metodo. Qualsiasi implementazione di IConnectionPointContainer deve implementare questo metodo per le interfacce in uscita dell'oggetto connettibile.

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

IConnectionPoint

IConnectionPointContainer