CBasePropertyPage.OnConnect-Methode

Die OnConnect -Methode stellt einen IUnknown-Zeiger auf das Der Eigenschaftenseite zugeordnete Objekt zur Seite.

Syntax

virtual HRESULT OnConnect(
   IUnknown *pUnknown
);

Parameter

pUnknown

Zeiger auf die IUnknown-Schnittstelle des -Objekts.

Rückgabewert

Die Basisklassenimplementierung gibt S _ OK zurück.

Hinweise

Die CBasePropertyPage::SetObjects-Methode ruft die OnConnect -Methode auf. Überschreiben Sie diese Methode, um einen Zeiger auf das von pUnknown angegebene Objekt zu speichern. Sie können entweder den pUnknown-Zeiger selbst speichern oder diesen Zeiger für andere Schnittstellen abfragen. Wenn Sie den pUnknown-Zeiger speichern, rufen Sie AddRef auf, bevor zurückgegeben OnConnect wird.

Verwenden Sie in der CBasePropertyPage::OnActivate-Methode den gespeicherten Zeiger (oder Zeiger), um Anfangswerte für die Dialogeigenschaften abzurufen. Wenden Sie in der CBasePropertyPage::OnApplyChanges-Methode alle Änderungen zurück auf das -Objekt an. Geben Sie alle Zeiger in der CBasePropertyPage::OnDisconnect-Methode frei.

Beispiele

HRESULT CMyProp::OnConnect(IUnknown *pUnk)
{
    ASSERT(m_pOwningFilter == NULL);
    HRESULT hr;
    // Query pUnk for the filter's custom interface.
    hr = pUnk->QueryInterface(IID_ISomeCustomInterface,
             reinterpret_cast<void**>(&m_pOwningFilter));
    return hr;
}

Anforderungen

Anforderung Wert
Header
Cprop.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandels-Builds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBasePropertyPage-Klasse