Metodo IPropertyStore::GetValue (propsys.h)
Questo metodo recupera i dati per una proprietà specifica.
Sintassi
HRESULT GetValue(
REFPROPERTYKEY key,
PROPVARIANT *pv
);
Parametri
key
TBD
pv
Dopo che il IPropertyStore::GetValue metodo restituisce correttamente, questo parametro punta a una struttura PROPVARIANT che contiene dati sulla proprietà.
Valore restituito
Restituisce S_OK o INPLACE_S_TRUNCATED se ha esito positivo o un valore di errore in caso contrario.
INPLACE_S_TRUNCATED viene restituito per indicare che il PROPVARIANT restituito è stato convertito in una forma più canonica. Ad esempio, questa operazione verrà eseguita per tagliare gli spazi iniziali o finali da un valore stringa. È necessario usare la macro SUCCEEDED per controllare il valore restituito, che considera INPLACE_S_TRUNCATED come codice riuscito. La macro SUCCEEDED è definita nel file Winerror.h.
Commenti
Se propertyKEY a cui fa riferimento nella chiave non è presente nell'archivio delle proprietà, questo metodo restituisce S_OK e il membro vt della struttura a cui fa riferimento è impostato su VT_EMPTY.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile con Windows Vista e versioni successive del sistema operativo Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | propsys.h |
| Libreria | Propsys.idl |
| IRQL | Tutti i livelli |