IOleItemContainer::GetObjectStorage-Methode (oleidl.h)

Artikel
03/04/2024

Ruft einen Zeiger auf den Speicher für das angegebene Objekt ab.

Syntax

HRESULT GetObjectStorage(
  [in]  LPOLESTR pszItem,
  [in]  IBindCtx *pbc,
  [in]  REFIID   riid,
  [out] void     **ppvStorage
);

Parameter

[in] pszItem

Der Name des Verbunddokuments für das Objekt, dessen Speicherung angefordert wird.

[in] pbc

Ein Zeiger auf die IBindCtx-Schnittstelle im Bindungskontext, der in diesem Bindungsvorgang verwendet werden soll. Der Bindungskontext speichert Während des Bindungsprozesses gebundene Objekte zwischen, enthält Parameter, die für alle Vorgänge mit dem Bindungskontext gelten, und stellt die Mittel bereit, mit denen die Bindungsimplementierung Informationen über ihre Umgebung abrufen soll.

[in] riid

Ein Verweis auf den Bezeichner der Schnittstelle, die für die Kommunikation mit dem -Objekt verwendet werden soll, in der Regel IStorage.

[out] ppvStorage

Adresse einer Zeigervariablen, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvStorage den angeforderten Schnittstellenzeiger auf den Speicher für das Objekt namens pszItem. Bei erfolgreicher Implementierung muss AddRef für *ppvStorage aufgerufen werden. Es liegt in der Verantwortung des Aufrufers, Release aufzurufen. Wenn ein Fehler auftritt, wird *ppvStorage auf NULL festgelegt.

Rückgabewert

Diese Methode kann den Standardrückgabewert E_OUTOFMEMORY sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die -Methode vollständig erfolgreich.
MK_E_OBJECT	Der Parameter pszItem identifiziert kein Objekt in diesem Container.
MK_E_NOSTORAGE	Das -Objekt verfügt nicht über einen eigenen unabhängigen Speicher.
E_NOINTERFACE	Die angeforderte Schnittstelle ist nicht verfügbar.

Hinweise

Die Elementmonikerimplementierung von IMoniker::BindToStorage ruft diese Methode auf.

Hinweise für Implementierer

Wenn pszItem ein Pseudoobjekt festlegt, sollte Ihre Implementierung von IOleItemContainer::GetObjectStorage MK_E_NOSTORAGE zurückgeben, da Pseudoobjekte keinen eigenen unabhängigen Speicher haben. Wenn pszItem ein eingebettetes Objekt oder einen Teil des Dokuments mit eigenem Speicher festlegt, sollte ihre Implementierung den angegebenen Schnittstellenzeiger für das entsprechende Speicherobjekt zurückgeben.

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

Weitere Informationen

IOleItemContainer