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
| 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 |