StgOpenPropStg-Funktion (coml2api.h)

Artikel
08/22/2023

Die StgOpenPropStg-Funktion öffnet eine angegebene Eigenschaft, die in einem angegebenen Speicher- oder Streamobjekt festgelegt ist. Der Eigenschaftssatz stellt die vom System bereitgestellte eigenständige Implementierung der IPropertyStorage-Schnittstelle bereit.

Syntax

HRESULT StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parameter

[in] pUnk

Der Schnittstellenzeiger für die IUnknown-Schnittstelle auf dem Speicher- oder Streamobjekt, das das angeforderte Eigenschaftssatzobjekt enthält.

[in] fmtid

Die FMTID der zu öffnenden Eigenschaft.

[in] grfFlags

Die Werte aus PROPSETFLAG-Konstanten.

[in] dwReserved

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

[out] ppPropStg

Ein Zeiger auf eine IPropertyStorage*-Zeigervariable, die den Schnittstellenzeiger auf den angeforderten Eigenschaftensatz empfängt.

Rückgabewert

Diese Funktion unterstützt zusätzlich die folgenden Standardrückgabewerte E_INVALIDARG und E_UNEXPECTED:

Hinweise

StgOpenPropStg öffnet den angeforderten Eigenschaftensatz und stellt die vom System bereitgestellte eigenständige Implementierung der IPropertyStorage-Schnittstelle bereit. Der angeforderte Eigenschaftssatz ist im speicher- oder stream-Objekt enthalten, das von pUnk angegeben wird. Der Wert des grfFlags-Parameters gibt an, ob pUnk ein Speicher- oder Streamobjekt angibt. Wenn beispielsweise PROPSETFLAG_NONSIMPLE festgelegt ist, kann pUnk nach einer IStorage-Schnittstelle für ein Speicherobjekt abgefragt werden.

In beiden Fällen ruft diese Funktion pUnk-AddRef> für das Speicher- oder Streamobjekt auf, das den Eigenschaftensatz enthält. Der Aufrufer muss das Objekt freigeben, wenn es nicht mehr benötigt wird.

Diese Funktion ähnelt der IPropertySetStorage::Open-Methode . StgOpenPropStg fügt jedoch die Parameter pUnk und grfFlags hinzu, einschließlich des PROPSETFLAG_UNBUFFERED-Werts für den grfFlags-Parameter. Verwenden Sie diese Funktion anstelle der Open-Methode, wenn Sie über eine IStorage-Schnittstelle verfügen, die die IPropertySetStorage-Schnittstelle nicht unterstützt, oder wenn Sie den wert PROPSETFLAG_UNBUFFERED verwenden möchten. Weitere Informationen zur Verwendung von PROPSETFLAG_UNBUFFERED finden Sie unter PROPSETFLAG-Konstanten.

Der grfFlags-Parameter ist eine Kombination von Werten aus PROPSETFLAG-Konstanten. Der neue Enumerationswert PROPSETFLAG_UNBUFFERED wird unterstützt. Weitere Informationen finden Sie unter PROPSETFLAG-Konstanten.

Diese Funktion wird aus der verteilbaren iprop.dll exportiert, die in Windows NT 4.0 mit Service Pack 2 (SP2) enthalten ist und als Verteiler in Windows 95 und höher verfügbar ist. In Windows 2000 wird es aus Ole32.dll exportiert. Es kann auch aus iprop.dll in Windows 2000 exportiert werden, aber der Aufruf wird an ole32.dll weitergeleitet.

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	coml2api.h (einschließlich Propidl.h)
Bibliothek	Ole32.lib
DLL	Ole32.dll