Metodo IPersistSerializedPropStorage::GetPropertyStorage (propsys.h)

Ottiene i dati di archiviazione delle proprietà serializzati dall'istanza dell'archivio delle proprietà.

Sintassi

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

Parametri

[out] ppsps

Tipo: SERIALIZEDPROPSTORAGE**

Quando termina, questo metodo contiene l'indirizzo di un puntatore ai dati di archiviazione delle proprietà serializzati.

[out] pcb

Tipo: DWORD*

Quando termina, questo metodo contiene il numero di byte contenuti nei dati di archiviazione delle proprietà serializzati a cui punta ppsps.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il tipo SERIALIZEDPROPSTORAGE è definito in Propsys.h come tipo incompleto. Deve essere considerato come una matrice di valori BYTE ; il formato dei dati restituiti non è specificato. Il contenuto della struttura SERIALIZEDPROPSTORAGE è adatto per la persistenza su disco o in un'altra risorsa di archiviazione e può essere usato per inizializzare un altro archivio di proprietà tramite IPersistSerializedPropStorage::SetPropertyStorage.

Nota È responsabilità dell'applicazione che chiama IPersistSerializedPropStorage::GetPropertyStorage per chiamare in seguito CoTaskMemFree per rilasciare la memoria a cui fa riferimento ppsps quando non è più necessaria.

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h