StgCreatePropStg-Funktion (coml2api.h)

Artikel
08/22/2023

Die StgCreatePropStg-Funktion erstellt und öffnet einen Eigenschaftssatz in einem angegebenen Speicher- oder Streamobjekt. Der Eigenschaftssatz stellt die vom System bereitgestellte eigenständige Implementierung der IPropertyStorage-Schnittstelle bereit.

Syntax

HRESULT StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parameter

[in] pUnk

Ein Zeiger auf die IUnknown-Schnittstelle im Speicher- oder Streamobjekt, in dem der neue Eigenschaftssatz gespeichert wird.

[in] fmtid

Die FMTID der zu erstellenden Eigenschaft.

[in] pclsid

Ein Zeiger auf die anfängliche CLSID für diesen Eigenschaftssatz. Kann NULL sein, in diesem Fall wird pclsid auf alle Nullen festgelegt.

[in] grfFlags

Die Werte aus PROPSETFLAG-Konstanten , die bestimmen, wie der Eigenschaftensatz erstellt und geöffnet wird.

[in] dwReserved

Reserviert; muss null sein.

[out] ppPropStg

Die Adresse einer IPropertyStorage*-Zeigervariable, die den Schnittstellenzeiger auf den neuen Eigenschaftensatz empfängt.

Rückgabewert

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

Hinweise

StgCreatePropStg erstellt und öffnet einen neuen Eigenschaftensatz, der die vom System bereitgestellte eigenständige Implementierung der IPropertyStorage-Schnittstelle bereitstellt. Der neue Eigenschaftensatz 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. Es liegt in der Verantwortung des Aufrufers, das Objekt freizugeben, wenn es nicht mehr benötigt wird.

Diese Funktion ähnelt der IPropertySetStorage::Create-Methode . StgCreatePropStg fügt jedoch den pUnk-Parameter hinzu und unterstützt den PROPSETFLAG_UNBUFFERED-Wert für den grfFlags-Parameter. Verwenden Sie diese Funktion anstelle der Create-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 dieses PROPSETFLAG_UNBUFFERED Enumerationswerts finden Sie unter PROPSETFLAG-Konstanten.

Der Eigenschaftensatz enthält automatisch Codepage- und Gebietsschemabezeichnereigenschaften (ID). Diese werden auf den aktuellen Systemstandard bzw. den aktuellen Benutzerstandard festgelegt.

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) und höher enthalten ist und als Verteiler in Windows 95, Windows 98 und höher verfügbar ist. In Windows 2000 und Windows XP wird es aus ole32.dll exportiert. Es kann auch aus iprop.dll in Windows 2000 und Windows XP 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