Método IPropertyStorage::ReadMultiple (propidlbase.h)

Artigo
08/25/2023

O método ReadMultiple lê as propriedades especificadas do conjunto de propriedades atual.

Sintaxe

HRESULT ReadMultiple(
  [in]  ULONG             cpspec,
  [in]  const PROPSPEC [] rgpspec,
  [out] PROPVARIANT []    rgpropvar
);

Parâmetros

[in] cpspec

A contagem numérica de propriedades a serem especificadas na matriz rgpspec . O valor desse parâmetro pode ser definido como zero; no entanto, isso derrota a finalidade do método, pois nenhuma propriedade é lida, independentemente dos valores definidos em rgpspec.

[in] rgpspec

Uma matriz de estruturas PROPSPEC especifica quais propriedades são lidas. As propriedades podem ser especificadas por uma ID de propriedade ou por um nome de cadeia de caracteres opcional. Não é necessário especificar propriedades em nenhuma ordem específica na matriz. A matriz pode conter propriedades duplicadas, resultando em valores de propriedade duplicados no retorno para propriedades simples. As propriedades não simplificadas devem retornar o acesso negado na tentativa de abri-las uma segunda vez. A matriz pode conter uma combinação de IDs de propriedade e IDs de cadeia de caracteres.

[out] rgpropvar

Matriz alocada pelo chamador de uma estrutura PROPVARIANT que, no retorno, contém os valores das propriedades especificadas pelos elementos correspondentes na matriz rgpspec . A matriz deve ser pelo menos grande o suficiente para conter valores do parâmetro cpspec da estrutura PROPVARIANT . O parâmetro cpspec especifica o número de propriedades definidas na matriz. O chamador não é necessário para inicializar esses valores de estrutura PROPVARIANT em qualquer ordem específica. No entanto, a implementação deve preencher todos os membros corretamente no retorno. Se não houver outro valor apropriado, a implementação deverá definir o membro vt de cada estrutura PROPVARIANT como VT_EMPTY.

Retornar valor

Esse método dá suporte ao valor de retorno padrão E_UNEXPECTED, bem como o seguinte:

Essa função também pode retornar quaisquer erros do sistema de arquivos ou erros win32 encapsulados em um tipo de dados HRESULT . Para obter mais informações, consulte Estratégias de tratamento de erros.

Para obter mais informações, consulte Considerações de armazenamento de propriedades.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	propidlbase.h (inclua Objbase.h, Propidlbase.h)
Biblioteca	Uuid.lib
DLL	Ole32.dll