StgCreatePropStg-Funktion (coml2api.h)
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 |
Weitere Informationen
IPropertySetStorage-Eigenständige Implementierung