IDiaPropertyStorage::ReadMultiple
Liest die angegebenen Eigenschaften aus dem aktuellen Eigenschaftensatz.
Syntax
HRESULT ReadMultiple(
ULONG cpspec,
PROPSPEC const rgpspec,
PROPVARIANT rgvar
);
Parameter
cpspec
[in] Anzahl der im rgpspec-Array angegebenen Eigenschaften. Wenn Null, gibt die Methode keine Eigenschaften zurück, sondern S_OK als Erfolgscode.
rgpspec
[in] Ein Array von Eigenschaften, die gelesen werden sollen. 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 bei dem Versuch, sie ein zweites Mal zu öffnen, „Zugriff verweigert“ zurückgeben. Das Array kann eine Mischung aus Eigenschafts-IDs und Zeichenfolgen-IDs enthalten. Dieses Array muss mindestens über eine Anzahl von cpspec Eigenschaftswerten verfügen.
rgvar
[in, out] Ein Array von PROPVARIANT-Strukturen (im „Microsoft.VisualStudio.OLE.Interop“-Namespace), das mit Werten für jede Eigenschaft ausgefüllt werden soll. Das Array muss mindestens cpspec Elemente groß sein. Der Aufrufer muss die Werte im Array nicht initialisieren.
Rückgabewert
Gibt bei Erfolg S_OK zurück. Gibt S_FALSE zurück, wenn mindestens eine der Eigenschaften nicht gefunden wurde. Andernfalls wird ein Fehlercode zurückgegeben.
Bemerkungen
Wenn eine Eigenschaft nicht gefunden wurde, enthält der entsprechende Eintrag im rgvar-Array einen VARIANT-Wert mit dem Typ VT_EMPTY.