IPropertyStorage::ReadMultiple-Methode (propidl.h)

Artikel
08/25/2023

Die ReadMultiple-Methode liest die angegebenen Eigenschaften aus dem aktuellen Eigenschaftensatz.

Syntax

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

Parameter

[in] cpspec

Die numerische Anzahl der Eigenschaften, die im rgpspec-Array angegeben werden sollen. Der Wert dieses Parameters kann auf 0 (null) festgelegt werden. Dies verfehlt jedoch den Zweck der -Methode, da dadurch keine Eigenschaften gelesen werden, unabhängig von den in rgpspec festgelegten Werten.

[in] rgpspec

Ein Array von PROPSPEC-Strukturen gibt an, welche Eigenschaften gelesen werden. Eigenschaften können entweder mit einer Eigenschaften-ID oder einem optionalen Zeichenfolgennamen angegeben werden. Es ist nicht erforderlich, Eigenschaften in einer bestimmten Reihenfolge im Array anzugeben. Das Array kann doppelte Eigenschaften enthalten, was bei der Rückgabe für einfache Eigenschaften zu doppelten Eigenschaftswerten führt. Nichtimple-Eigenschaften sollten den zugriff verweigern zurückgeben, wenn versucht wird, sie ein zweites Mal zu öffnen. Das Array kann eine Mischung aus Eigenschafts-IDs und Zeichenfolgen-IDs enthalten.

[out] rgpropvar

Vom Aufrufer zugeordnetes Array einer PROPVARIANT-Struktur , die bei der Rückgabe die Werte der Eigenschaften enthält, die von den entsprechenden Elementen im rgpspec-Array angegeben werden. Das Array muss mindestens groß genug sein, um Werte des cpspec-Parameters der PROPVARIANT-Struktur zu enthalten. Der cpspec-Parameter gibt die Anzahl der eigenschaften an, die im Array festgelegt sind. Der Aufrufer muss diese PROPVARIANT-Strukturwerte nicht in einer bestimmten Reihenfolge initialisieren. Die Implementierung muss jedoch bei der Rückgabe alle Member ordnungsgemäß ausfüllen. Wenn kein anderer geeigneter Wert vorhanden ist, muss die Implementierung den vt-Member jeder PROPVARIANT-Struktur auf VT_EMPTY festlegen.

Rückgabewert

Diese Methode unterstützt den Standardrückgabewert E_UNEXPECTED sowie Folgendes:

Diese Funktion kann auch Dateisystemfehler oder Win32-Fehler zurückgeben, die in einen HRESULT-Datentyp umschlossen sind. Weitere Informationen finden Sie unter Strategien zur Fehlerbehandlung.

Weitere Informationen finden Sie unter Überlegungen zur Eigenschaftsspeicherung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	propidl.h (include Objbase.h, Propidlbase.h)
Bibliothek	Uuid.lib
DLL	Ole32.dll