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

Vedi anche

Ipropertystore

IPropertyStore::GetAt