IPersistSerializedPropStorage::GetPropertyStorage-Methode (propsys.h)

Artikel
03/04/2024

Ruft die serialisierten Eigenschaftenspeicherdaten aus dem Eigenschaftenspeicher instance ab.

Syntax

HRESULT GetPropertyStorage(
  [out] SERIALIZEDPROPSTORAGE **ppsps,
  [out] DWORD                 *pcb
);

Parameter

[out] ppsps

Typ: SERIALIZEDPROPSTORAGE**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf die serialisierten Eigenschaftenspeicherdaten.

[out] pcb

Typ: DWORD*

Wenn diese Methode zurückgibt, enthält die Anzahl der Bytes, die in den serialisierten Eigenschaftsspeicherdaten enthalten sind, auf die ppsps verweisen.

Rückgabewert

Typ: HRESULT

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

Hinweise

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.

Hinweis Es liegt in der Verantwortung der Anwendung, die IPersistSerializedPropStorage::GetPropertyStorage aufruft, um später CoTaskMemFree aufzurufen, um den arbeitsspeicher freizugeben, auf den ppsps verwiesen wird, wenn er nicht mehr benötigt wird.

Anforderungen

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

Freigeben über