Metodo IPropertyStorage::ReadPropertyNames (propidl.h)

Il metodo ReadPropertyNames recupera tutti i nomi di stringa esistenti per gli ID di proprietà specificati.

Sintassi

HRESULT ReadPropertyNames(
  [in]      ULONG           cpropid,
  [in]      const PROPID [] rgpropid,
  [in, out] LPOLESTR []     rglpwstrName
);

Parametri

[in] cpropid

Numero di elementi nell'input della matrice rgpropid. Il valore di questo parametro può essere impostato su zero, tuttavia ciò impedisce la lettura dello scopo di questo metodo perché non vengono letti nomi di proprietà.

[in] rgpropid

Matrice di ID di proprietà per i quali recuperare i nomi.

[in, out] rglpwstrName

Matrice allocata dal chiamante di dimensioni cpropid dei membri LPWSTR . In caso di restituzione, l'implementazione compila questa matrice. Una determinata voce contiene il nome stringa corrispondente di un ID proprietà oppure può essere vuota se l'ID proprietà non ha nomi di stringa.

Ogni membro LPWSTR della matrice deve essere liberato usando la funzione CoTaskMemFree .

Valore restituito

Questo metodo supporta il valore restituito standard E_UNEXPECTED, oltre ai seguenti:

Commenti

Per ogni ID di proprietà nell'elenco di ID di proprietà forniti nella matrice rgpropid , ReadPropertyNames recupera il nome della stringa corrispondente, se presente. I nomi di stringa vengono creati specificando i nomi nelle chiamate a IPropertyStorage::WriteMultiple durante la creazione della proprietà o tramite una chiamata a IPropertyStorage::WritePropertyNames. In entrambi i casi, il nome della stringa è facoltativo, ma tutte le proprietà devono avere un ID proprietà.

I nomi di stringa mappati agli ID di proprietà devono essere univoci all'interno del set.

Requisiti

Vedi anche

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames