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

Artículo
03/01/2024

El método ReadMultiple lee las propiedades especificadas del conjunto de propiedades actual.

Sintaxis

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

Parámetros

[in] cpspec

Recuento numérico de propiedades que se van a especificar en la matriz rgpspec . El valor de este parámetro se puede establecer en cero; sin embargo, esto anula el propósito del método, ya que no se leen propiedades, independientemente de los valores establecidos en rgpspec.

[in] rgpspec

Una matriz de estructuras PROPSPEC especifica qué propiedades se leen. Las propiedades se pueden especificar mediante un identificador de propiedad o un nombre de cadena opcional. No es necesario especificar propiedades en ningún orden determinado de la matriz. La matriz puede contener propiedades duplicadas, lo que da como resultado valores de propiedad duplicados en la devolución de propiedades simples. Las propiedades nomples deben devolver el acceso denegado al intentar abrirlas una segunda vez. La matriz puede contener una combinación de identificadores de propiedad e identificadores de cadena.

[out] rgpropvar

Matriz asignada por el autor de la llamada de una estructura PROPVARIANT que, de vuelta, contiene los valores de las propiedades especificadas por los elementos correspondientes de la matriz rgpspec . La matriz debe ser lo suficientemente grande como para contener los valores del parámetro cpspec de la estructura PROPVARIANT . El parámetro cpspec especifica el número de propiedades establecidas en la matriz. El autor de la llamada no es necesario para inicializar estos valores de estructura PROPVARIANT en ningún orden específico. Sin embargo, la implementación debe rellenar correctamente todos los miembros al devolver. Si no hay ningún otro valor adecuado, la implementación debe establecer el miembro vt de cada estructura PROPVARIANTen VT_EMPTY.

Valor devuelto

Este método admite el valor devuelto estándar E_UNEXPECTED, así como lo siguiente:

Esta función también puede devolver cualquier error del sistema de archivos o errores de Win32 encapsulados en un tipo de datos HRESULT . Para obtener más información, consulte Estrategias de control de errores.

Para obtener más información, vea Consideraciones sobre el almacenamiento de propiedades.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	propidlbase.h (include Objbase.h, Propidlbase.h)
Library	Uuid.lib
Archivo DLL	Ole32.dll