Share via

Método IPersistSerializedPropStorage::GetPropertyStorage (propsys.h)

  • Artigo

Obtém os dados de armazenamento de propriedades serializados da instância do repositório de propriedades.

Sintaxe

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

Parâmetros

[out] ppsps

Tipo: SERIALIZEDPROPSTORAGE**

Quando esse método retorna, contém o endereço de um ponteiro para os dados de armazenamento de propriedade serializados.

[out] pcb

Tipo: DWORD*

Quando esse método retorna, contém a contagem de bytes contidos nos dados de armazenamento de propriedades serializados apontados por ppsps.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O tipo SERIALIZEDPROPSTORAGE é definido em Propsys.h como um tipo incompleto. Ela deve ser tratada como uma matriz de valores BYTE ; o formato dos dados retornados não é especificado. O conteúdo da estrutura SERIALIZEDPROPSTORAGE é adequado para persistir no disco ou em outro armazenamento e pode ser usado para inicializar outro repositório de propriedades por meio de IPersistSerializedPropStorage::SetPropertyStorage.

Nota É responsabilidade do aplicativo que chama IPersistSerializedPropStorage::GetPropertyStorage chamar CoTaskMemFree posteriormente para liberar a memória referenciada por ppsps quando ela não for mais necessária.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho propsys.h