IPropertyStorage::ReadMultiple-Methode (propidlbase.h)

Artikel
03/04/2024

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 null festgelegt werden. dies verfehlt jedoch den Zweck der Methode, da 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. Nicht einfache Eigenschaften sollten den zugriff verweigert 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 zugewiesenes 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 im Array festgelegten Eigenschaften an. 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 das 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 alle Dateisystemfehler oder Win32-Fehler zurückgeben, die in einen HRESULT-Datentyp eingeschlossen sind. Weitere Informationen finden Sie unter Strategien zur Fehlerbehandlung.

Weitere Informationen finden Sie unter Überlegungen zur Eigenschaftenspeicherung.

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	propidlbase.h (include Objbase.h, Propidlbase.h)
Bibliothek	Uuid.lib
DLL	Ole32.dll