IOleDocument::CreateView-Methode (docobj.h)

Artikel
02/26/2024

Erstellt ein Dokumentansichtsobjekt im Prozess des Aufrufers und ruft einen Zeiger auf die IOleDocumentView-Schnittstelle dieses Objekts ab.

Syntax

HRESULT CreateView(
  [in]  IOleInPlaceSite  *pIPSite,
  [in]  IStream          *pstm,
  [in]  DWORD            dwReserved,
  [out] IOleDocumentView **ppView
);

Parameter

[in] pIPSite

Ein Zeiger auf die IOleInPlaceSite-Schnittstelle , die das Ansichtswebsiteobjekt darstellt, das dem neuen Dokumentansichtsobjekt zugeordnet werden soll. Dieser Parameter kann beispielsweise NULL sein, wenn die Ansicht in einem neuen, nicht initialisierten Dokumentobjekt enthalten ist. In diesem Fall muss der Aufrufer die Ansicht mit einem nachfolgenden Aufruf von IOleDocumentView::SetInPlaceSite initialisieren.

[in] pstm

Ein Zeiger auf einen Stream, der Daten enthält, aus denen sich das neue Dokumentansichtsobjekt selbst initialisieren soll. Wenn NULL, initialisiert das Dokumentobjekt das neue Dokumentansichtsobjekt mit einem Standardzustand.

[in] dwReserved

Dieser Parameter ist reserviert und muss null sein.

[out] ppView

Ein Zeiger auf eine IOleDocumentView-Zeigervariable , die den Schnittstellenzeiger auf das neue Dokumentansichtsobjekt empfängt. Bei erfolgreicher Ausführung ist der Aufrufer für den Aufruf von IUnknown::Release für den ppview-Zeiger verantwortlich, wenn das View-Objekt nicht mehr benötigt wird.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_FAIL	Fehler beim Vorgang.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher für den Vorgang.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.
E_POINTER	Die Adresse in ppView ist NULL.

Hinweise

Die Dokumentwebsite eines Dokumentobjektcontainers ruft CreateView auf, um ein Dokumentobjekt anzuweisen, eine neue Ansicht von sich selbst im Prozess des Containers zu erstellen, entweder aus Standarddaten oder mithilfe des Inhalts eines vorhandenen Datenstroms.

Das Aufrufen von CreateView führt nicht dazu, dass die neue Ansicht selbst angezeigt wird. Hierfür ist ein Aufruf von IOleDocumentView::Show oder IOleDocumentView::UIActivate erforderlich.

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	docobj.h