Método IPropertyStore::GetValue (propsys.h)

  • Artículo

Este método recupera los datos de una propiedad específica.

Sintaxis

HRESULT GetValue(
  REFPROPERTYKEY key,
  PROPVARIANT    *pv
);

Parámetros

key

TBD

pv

Una vez que el IPropertyStore::GetValue método se devuelve correctamente, este parámetro apunta a una estructura PROPVARIANT que contiene datos sobre la propiedad .

Valor devuelto

Devuelve S_OK o INPLACE_S_TRUNCATED si se ejecuta correctamente o un valor de error de lo contrario.

INPLACE_S_TRUNCATED se devuelve para indicar que el PROPVARIANT devuelto se convirtió en una forma más canónica. Por ejemplo, esto se haría para recortar los espacios iniciales o finales de un valor de cadena. Debe usar la macro SUCCEEDED para comprobar el valor devuelto, que trata INPLACE_S_TRUNCATED como código correcto. La macro SUCCEEDED se define en el archivo Winerror.h.

Comentarios

Si el PROPERTYKEY al que se hace referencia en la clave no está presente en el almacén de propiedades, este método devuelve S_OK y el miembro vt de la estructura a la que apunta pv se establece en VT_EMPTY.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible con Windows Vista y versiones posteriores del sistema operativo Windows.
Plataforma de destino Universal
Encabezado propsys.h
Library Propsys.idl
IRQL Todos los niveles

Consulte también

IPropertyStore

IPropertyStore::GetAt