Metodo IPropertyStorage::ReadMultiple (propidlbase.h)

Articolo
08/25/2023

Il metodo ReadMultiple legge le proprietà specificate dal set di proprietà corrente.

Sintassi

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

Parametri

[in] cpspec

Numero numerico di proprietà da specificare nella matrice rgpspec . Il valore di questo parametro può essere impostato su zero; tuttavia, che sconfigge lo scopo del metodo perché non vengono lette proprietà, indipendentemente dai valori impostati in rgpspec.

[in] rgpspec

Una matrice di strutture PROPSPEC specifica le proprietà lette. Le proprietà possono essere specificate da un ID proprietà o da un nome stringa facoltativo. Non è necessario specificare le proprietà in qualsiasi ordine specifico nella matrice. La matrice può contenere proprietà duplicate, causando valori di proprietà duplicati in caso di restituzione di proprietà semplici. Le proprietà nonsimple devono restituire l'accesso negato in un tentativo di aprirle una seconda volta. La matrice può contenere una combinazione di ID proprietà e ID stringa.

[out] rgpropvar

Matrice allocata dal chiamante di una struttura PROPVARIANT che, in caso di restituzione, contiene i valori delle proprietà specificate dagli elementi corrispondenti nella matrice rgpspec . La matrice deve essere almeno grande per contenere valori del parametro cpspec della struttura PROPVARIANT . Il parametro cpspec specifica il numero di proprietà impostate nella matrice. Il chiamante non è necessario inizializzare questi valori di struttura PROPVARIANT in qualsiasi ordine specifico. Tuttavia, l'implementazione deve riempire tutti i membri correttamente al ritorno. Se non è presente alcun altro valore appropriato, l'implementazione deve impostare il membro vt di ogni struttura PROPVARIANT su VT_EMPTY.

Valore restituito

Questo metodo supporta il valore restituito standard E_UNEXPECTED, nonché quanto segue:

Questa funzione può anche restituire eventuali errori del file system o errori Win32 inclusi in un tipo di dati HRESULT . Per altre informazioni, vedere Strategie di gestione degli errori.

Per altre informazioni, vedere Considerazioni sull'archiviazione delle proprietà.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	propidlbase.h (include Objbase.h, Propidlbase.h)
Libreria	Uuid.lib
DLL	Ole32.dll