IOleControlSite::GetExtendedControl-Methode (ocidl.h)
Ruft einen IDispatch-Zeiger auf das erweiterte Steuerelement ab, das der Container zum Umschließen des tatsächlichen Steuerelements verwendet.
Syntax
HRESULT GetExtendedControl(
[out] IDispatch **ppDisp
);
Parameter
[out] ppDisp
Ein Zeiger auf eine IDispatch-Zeigervariable , die den Schnittstellenzeiger auf das erweiterte Steuerelement empfängt. Wenn ein Fehler auftritt, muss die Implementierung *ppDisp auf NULL festlegen. Bei Erfolg ist der Aufrufer für den Aufruf von Release verantwortlich, wenn *ppDisp nicht mehr benötigt wird.
Rückgabewert
Diese Methode kann die standardmäßigen Rückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der Container implementiert keine erweiterten Steuerelemente. |
|
Die Adresse in ppDisp oder *ppDisp ist ungültig. Es kann z. B. NULL sein. |
Hinweise
Diese Methode gewährt dem tatsächlichen Steuerelement Zugriff auf alle Eigenschaften und Methoden, die der Container im erweiterten Steuerelement verwaltet. Auf diese Eigenschaften und Methoden kann andernfalls nicht auf das Steuerelement zugegriffen werden.
Hinweise für Anrufer
Der zurückgegebene Zeiger liegt in der Verantwortung des Aufrufers, der ihn freigeben muss, wenn er nicht mehr benötigt wird.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ocidl.h |