Condividi tramite

Metodo IOleControlSite::GetExtendedControl (ocidl.h)

  • Articolo

Recupera un puntatore IDispatch al controllo esteso usato dal contenitore per eseguire il wrapping del controllo reale.

Sintassi

HRESULT GetExtendedControl(
  [out] IDispatch **ppDisp
);

Parametri

[out] ppDisp

Puntatore a una variabile del puntatore IDispatch che riceve il puntatore dell'interfaccia al controllo esteso. Se si verifica un errore, l'implementazione deve impostare *ppDisp su NULL. In caso di esito positivo, il chiamante è responsabile della chiamata a Release quando *ppDisp non è più necessario.

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_NOTIMPL
 Il contenitore non implementa controlli estesi.
E_POINTER
 L'indirizzo in ppDisp o *ppDisp non è valido. Ad esempio, può essere NULL.

Commenti

Questo metodo consente al controllo reale di accedere a qualsiasi proprietà e metodo gestito dal contenitore nel controllo esteso. Queste proprietà e metodi non sarebbero altrimenti accessibili al controllo.

Note ai chiamanti

Il puntatore restituito è responsabilità del chiamante, che deve rilasciarlo quando non è più necessario.

Requisiti

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

Vedi anche

IOleControlSite