IOleControlSite::GetExtendedControl-Methode (ocidl.h)

  • Artikel

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
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_NOTIMPL
 Der Container implementiert keine erweiterten Steuerelemente.
E_POINTER
 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

Weitere Informationen

IOleControlSite