Metodo IPropertyStorage::ReadMultiple (propidl.h)

Articolo
03/05/2024

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

Conteggio numerico delle 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 un ordine specifico nella matrice. La matrice può contenere proprietà duplicate, con conseguente restituzione di valori di proprietà duplicati per proprietà semplici. Le proprietà non disimple devono restituire l'accesso negato per un tentativo di aprirle una seconda volta. La matrice può contenere una combinazione di ID di 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 sufficientemente grande per contenere i valori del parametro cpspec della struttura PROPVARIANT . Il parametro cpspec specifica il numero di proprietà impostate nella matrice. Il chiamante non è necessario per inizializzare questi valori di struttura PROPVARIANT in un ordine specifico. Tuttavia, l'implementazione deve riempire correttamente tutti i membri 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é i seguenti:

Questa funzione può anche restituire eventuali errori del file system o errori Win32 di cui è stato eseguito il wrapping 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	propidl.h (include Objbase.h, Propidlbase.h)
Libreria	Uuid.lib
DLL	Ole32.dll