Partager via

Méthode IOleControlSite ::GetExtendedControl (ocidl.h)

  • Article

Récupère un pointeur IDispatch vers le contrôle étendu que le conteneur utilise pour encapsuler le contrôle réel.

Syntaxe

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

Paramètres

[out] ppDisp

Pointeur vers une variable pointeur IDispatch qui reçoit le pointeur d’interface vers le contrôle étendu. Si une erreur se produit, l’implémentation doit définir *ppDisp sur NULL. En cas de réussite, l’appelant est responsable de l’appel de Release lorsque *ppDisp n’est plus nécessaire.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour Description
S_OK
 La commande s'est correctement terminée.
E_NOTIMPL
 Le conteneur n’implémente pas de contrôles étendus.
E_POINTER
 L’adresse dans ppDisp ou *ppDisp n’est pas valide. Par exemple, il peut s’agir de NULL.

Remarques

Cette méthode donne au contrôle réel un accès aux propriétés et méthodes que le conteneur gère dans le contrôle étendu. Dans le cas contraire, ces propriétés et méthodes seraient inaccessibles au contrôle .

Remarques aux appelants

Le pointeur retourné est la responsabilité de l’appelant, qui doit le libérer quand il n’est plus nécessaire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête ocidl.h

Voir aussi

IOleControlSite