IDiaPropertyStorage::ReadMultiple
Odczytuje określone właściwości z bieżącego zestawu właściwości.
Składnia
HRESULT ReadMultiple(
ULONG cpspec,
PROPSPEC const rgpspec,
PROPVARIANT rgvar
);
Parametry
cpspec
[in] Liczba właściwości określonych w tablicy rgpspec . Jeśli zero, metoda nie zwraca żadnych właściwości, ale zwraca S_OK jako kod powodzenia.
rgpspec
[in] Tablica właściwości do odczytania. Właściwości można określić za pomocą identyfikatora właściwości lub opcjonalnej nazwy ciągu. Nie trzeba określać właściwości w żadnej określonej kolejności w tablicy. Tablica może zawierać zduplikowane właściwości, co powoduje zduplikowanie wartości właściwości zwracanych dla prostych właściwości. Właściwości inne niż proste powinny zwracać odmowa dostępu podczas próby otwarcia ich po raz drugi. Tablica może zawierać kombinację identyfikatorów właściwości i identyfikatorów ciągów. Ta tablica musi mieć co najmniej cpspec liczbę wartości właściwości.
rgvar
[in, out] Tablica PROPVARIANT struktur (w przestrzeni nazw Microsoft.VisualStudio.OLE.Interop) do wypełnienia wartościami dla każdej właściwości. Tablica musi być co najmniej cpspec elementami o rozmiarze. Obiekt wywołujący nie musi inicjować wartości w tablicy.
Wartość zwracana
Jeśli operacja powiedzie się, zwraca wartość S_OK. Zwraca wartość S_FALSE , jeśli nie znaleziono co najmniej jednej właściwości. W przeciwnym razie zwraca kod błędu.
Uwagi
Jeśli właściwość nie została znaleziona, odpowiedni wpis w rgvar tablicy zawiera VARIANT element o typie VT_EMPTY.