IPropertySetStorage::Open-Methode (propidl.h)

Artikel
08/25/2023

Die Open-Methode öffnet einen Eigenschaftensatz, der im Eigenschaftensatzspeicherobjekt enthalten ist.

Syntax

HRESULT Open(
  [in]  REFFMTID         rfmtid,
  [in]  DWORD            grfMode,
  [out] IPropertyStorage **ppprstg
);

Parameter

[in] rfmtid

Der Formatbezeichner (FMTID) der zu öffnenden Eigenschaft. Weitere Informationen zu bekannten und vordefinierten FMTIDs im Platform SDK finden Sie unter Vordefinierte Eigenschaftensatzformatbezeichner.

[in] grfMode

Der Zugriffsmodus, in dem der neu erstellte Eigenschaftensatz geöffnet werden soll. Diese Flags stammen aus STGM-Konstanten. Flags, die im Kontext dieser Methode verwendet werden können, und ihre Bedeutungen werden im folgenden Abschnitt hinweise beschrieben.

[out] ppprstg

Ein Zeiger auf die Zeigervariable IPropertyStorage , die den Schnittstellenzeiger auf das angeforderte Eigenschaftenspeicherunterobjekt empfängt.

Rückgabewert

Diese Methode unterstützt zusätzlich zu Folgendem den Standardrückgabewert E_UNEXPECTED:

Hinweise

Der Modus, in dem der Eigenschaftensatz geöffnet werden soll, wird im Parameter grfMode angegeben. Diese Flags stammen aus STGM-Konstanten, aber für diese Methode sind die rechtlichen Werte und ihre Bedeutung wie folgt (nur bestimmte Kombinationen dieser Flagwerte sind zulässig).

Wert	Bedeutung
STGM_DIRECT	Öffnet den Eigenschaftensatz ohne zusätzliche Transaktionsschachtelungsebene. Dies ist die Standardeinstellung (das Verhalten, wenn weder STGM_DIRECT noch STGM_TRANSACTED angegeben wird).
STGM_TRANSACTED	Öffnet den Eigenschaftssatz mit einer zusätzlichen Transaktionsschachtelungsebene (über die Transaktion hinaus, falls vorhanden, für dieses Eigenschaftssatzspeicherobjekt). Der Transacted-Modus ist nur für nicht einfache Eigenschaftssätze verfügbar. Änderungen im Eigenschaftensatz müssen mit einem Aufruf von IPropertyStorage::Commit committet werden, bevor sie für die Transaktion in diesem Eigenschaftensatzspeicher sichtbar sind.
STGM_READ	Öffnet den Eigenschaftensatz mit Lesezugriff. Leseberechtigung ist für den Eigenschaftensatzspeicher erforderlich.
STGM_WRITE	Öffnet den Eigenschaftensatz mit Schreibzugriff. Nicht alle Implementierungen von IPropertyStorage unterstützen diesen Modus.
STGM_READWRITE	Öffnet den Eigenschaftensatz mit Lese- und Schreibzugriff. Beachten Sie, dass dieses Flag nicht das binäre OR der Werte STGM_READ und STGM_WRITE ist.
STGM_SHARE_DENY_NONE	Nachfolgende Öffnungen des Eigenschaftssatzes aus diesem Eigenschaftensatzspeicher werden nicht lese- oder schreibzugriff verweigert. (Nicht in allen Implementierungen verfügbar.)
STGM_SHARE_DENY_READ	Nachfolgende Öffnungen des Eigenschaftensatzes aus diesem Eigenschaftensatzspeicher werden lesezugriff verweigert. Nicht in allen Implementierungen verfügbar.
STGM_SHARE_DENY_WRITE	Nachfolgende Öffnungen des Eigenschaftensatzes aus diesem Eigenschaftensatzspeicher werden schreibzugriff verweigert. Dieser Wert wird in der Regel im Transaktionsmodus verwendet, um zu verhindern, dass unnötige Kopien eines Objekts erstellt werden, das von mehreren Benutzern geöffnet wird. Das heißt, wenn STGM_TRANSACTED angegeben ist, aber dieser Wert nicht angegeben wird, wird eine Momentaufnahme erstellt, unabhängig davon, ob nachfolgende Öffnungen vorhanden sind oder nicht. Daher können Sie die Leistung verbessern, indem Sie diesen Wert angeben. Nicht in allen Implementierungen verfügbar.
STGM_SHARE_EXCLUSIVE	Nachfolgende Öffnungen des Eigenschaftensatzes aus diesem Eigenschaftensatzspeicher sind nicht möglich. Beachten Sie, dass es sich bei diesem Wert nicht um ein einfaches binäres OR der elemente STGM_SHARE_DENY_READ und STGM_SHARE_DENY_WRITE handelt.

Diese Methode unterliegt den Einschränkungen des zugrunde liegenden IStorage::OpenStream (für einfache Eigenschaftssätze) oder IStorage::OpenStorage (für nicht einfache Eigenschaftssätze). Weitere Informationen zu einfachen und nicht einfachen Eigenschaftensätzen finden Sie unter Storage and Stream Objects for a Property Set. Wenn Sie beispielsweise die IPropertySetStorage-Verbunddateiimplementierung verwenden, müssen Sie STGM_SHARE_EXCLUSIVE im grfMode-Parameter für IPropertySetStorage::Open angeben. Umgekehrt unterliegt IPropertySetStorage-Eigenständige ImplementierungIPropertySetStorage::Open Einschränkungen, die für das vom Aufrufer angegebene IStorage gelten.

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	propidl.h (include Objbase.h)
Bibliothek	Uuid.lib
DLL	Ole32.dll