IPersistSerializedPropStorage2::GetPropertyStorageBuffer-Methode (propsys.h)

Artikel
03/04/2024

Ruft den serialisierten Eigenschaftenspeicherpuffer aus dem Eigenschaftenspeicher instance ab.

Syntax

HRESULT GetPropertyStorageBuffer(
  [out] SERIALIZEDPROPSTORAGE *psps,
  [in]  DWORD                 cb,
  [out] DWORD                 *pcbWritten
);

Parameter

[out] psps

Typ: SERIALIZEDPROPSTORAGE*

Wenn diese Methode erfolgreich zurückgegeben wird, enthält den Inhalt des Eigenschaftenspeicherpuffers.

[in] cb

Art: DWORD

Die anfängliche Größe des Puffers in Bytes, auf den psps verweist

[out] pcbWritten

Typ: DWORD*

Die Anzahl der Bytes, die im speicherpuffer für serialisierte Eigenschaften enthalten sind, auf den psps verweist.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode gibt einen Fehler zurück, wenn cb kleiner als die Gesamtgröße der serialisierten Daten ist.

Der SERIALIZEDPROPSTORAGE-Typ wird in Propsys.h als unvollständiger Typ definiert. Es sollte als Array von BYTE-Werten behandelt werden. Das Format der zurückgegebenen Daten wird nicht angegeben. Der Inhalt der SERIALIZEDPROPSTORAGE-Struktur eignet sich zum Beibehalten auf Datenträger oder anderen Speicher und kann verwendet werden, um einen anderen Eigenschaftenspeicher über IPersistSerializedPropStorage::SetPropertyStorage zu initialisieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propsys.h

Freigeben über