IStorage::OpenStorage-Methode (objidl.h)

Die OpenStorage-Methode öffnet ein vorhandenes Speicherobjekt mit dem angegebenen Namen im angegebenen Zugriffsmodus.

Syntax

HRESULT OpenStorage(
  [in]  const OLECHAR *pwcsName,
  [in]  IStorage      *pstgPriority,
  [in]  DWORD         grfMode,
  [in]  SNB           snbExclude,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstg
);

Parameter

[in] pwcsName

Ein Zeiger auf ein Breitzeichen-Unicode-Zeichenfolge, die auf NULL endet und die den Namen des Speicherobjekts enthält, das geöffnet wird. Die Zeichen 000 bis 01f, welche als erste Zeichen des Namens des Datenstroms/Speichers dienen, sind durch die OLE für die Benutzung reserviert. Dies ist eine Verbunddateieinschränkung, keine strukturierte Speichereinschränkung. Es wird ignoriert, wenn pstgPriority nicht NULL ist.

[in] pstgPriority

Muss NULL sein. Ein Wert ohne NULL gibt STG_E_INVALIDPARAMETER zurück.

[in] grfMode

Bezeichnet den bei der Öffnung des Speicherobjekts zu verwendenden Zugriffsmodus. Beschreibungen der möglichen Werte finden Sie unter STGM-Konstanten. Andere Modi, die Sie auswählen, müssen mindestens STGM_SHARE_EXCLUSIVE angeben, wenn diese Methode aufgerufen wird.

[in] snbExclude

Muss NULL sein. Ein Wert ohne NULL gibt STG_E_INVALIDPARAMETER zurück.

[in] reserved

Für die zukünftige Verwendung reserviert. Muss 0 (null) sein.

[out] ppstg

Zeigen Sie bei erfolgreicher Ausführung auf den Speicherort eines IStorage-Zeigers auf das geöffnete Speicherobjekt. Dieser Parameter wird auf NULL festgelegt, wenn ein Fehler auftritt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Das Speicherobjekt wurde erfolgreich geöffnet.
E_PENDING	Nur asynchroner Speicher: Ein Teil oder alle Daten des Speichers sind derzeit nicht verfügbar.
STG_E_ACCESSDENIED	Nicht genügend Berechtigungen zum Öffnen des Speicherobjekts.
STG_E_FILENOTFOUND	Das Speicherobjekt mit dem angegebenen Namen ist nicht vorhanden.
STG_E_INSUFFICIENTMEMORY	Das Speicherobjekt wurde aufgrund eines Mangels an Arbeitsspeicher nicht geöffnet.
STG_E_INVALIDFLAG	Der für den grfMode-Parameter angegebene Wert ist kein gültiger STGM-Konstantenwert .
STG_E_INVALIDFUNCTION	Die angegebene Kombination von Flags im grfMode-Parameter wird nicht unterstützt.
STG_E_INVALIDNAME	Kein gültiger Wert für pwcsName.
STG_E_INVALIDPOINTER	Der für das Speicherobjekt angegebene Zeiger war ungültig.
STG_E_INVALIDPARAMETER	Einer der Parameter war ungültig.
STG_E_REVERTED	Das Speicherobjekt wurde durch einen rückgängig machen Vorgang darüber in der Transaktionsstruktur ungültig gemacht.
STG_E_TOOMANYOPENFILES	Das Speicherobjekt wurde nicht erstellt, da zu viele dateien geöffnet sind.
STG_S_CONVERTED	Der vorhandene Stream mit dem angegebenen Namen wurde durch ein neues Speicherobjekt ersetzt, das einen einzelnen Stream namens CONTENTS enthält. Im direkten Modus wird der neue Speicher sofort auf den Datenträger geschrieben. Im Transaktionsmodus wird der neue Speicher in einen temporären Speicher im Arbeitsspeicher geschrieben und später beim Commit auf den Datenträger geschrieben.

Hinweise

Wenn der pstgPriority-ParameterNULL ist, wird er ignoriert. Wenn der pstgPriority-Parameter nicht NULL ist, handelt es sich um einen IStorage-Zeiger auf ein vorheriges Öffnen eines Elements des Speicherobjekts, das normalerweise im Prioritätsmodus geöffnet wurde. Das Speicherobjekt sollte gemäß grfMode geschlossen und erneut geöffnet werden. Wenn die IStorage::OpenStorage-Methode zurückgibt, ist pstgPriority nicht mehr gültig. Verwenden Sie den im ppstg-Parameter angegebenen Wert.

Speicherobjekte können mit STGM_DELETEONRELEASE geöffnet werden. In diesem Fall wird das Objekt zerstört, wenn es seine endgültige Freigabe erhält. Dies ist nützlich, um temporäre Speicherobjekte zu erstellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	objidl.h
Bibliothek	Uuid.lib
DLL	Ole32.dll

Weitere Informationen

IStorage – Implementierung zusammengesetzter Dateien

IStorage::CreateStorage