Méthode IOleControlSite ::GetExtendedControl (ocidl.h)
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 |
|---|---|
|
La commande s'est correctement terminée. |
|
Le conteneur n’implémente pas de contrôles étendus. |
|
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 |