Método IPortableDeviceValues::GetValue

El método GetValue recupera un valor PROPVARIANT especificado por una clave.

Sintaxis

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

Parámetros

key [in]

Clave REFPROPERTYKEY que especifica el elemento que se va a recuperar.

pValue [out]

Puntero al valor PROPVARIANT recuperado. El autor de la llamada debe liberar la memoria llamando a PropVariantClear cuando haya terminado con ella.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	La propiedad especificada por la clave no está en la colección.

Comentarios

Cuando se VT_VECTOR o VT_UI1 varTYPE para pValue , no se admite la recuperación de un búfer null o de tamaño cero. Por ejemplo, no se permiten pValue.caub.pElems = NULL ni pValue.caub.cElems = 0.

Este método se puede usar para recuperar un valor de cualquier tipo de la colección. Sin embargo, si conoce el tipo de valor de antemano, use uno de los métodos de recuperación especializados de esta interfaz para evitar la sobrecarga de trabajar directamente con valores PROPVARIANT.

Requisitos

Requisito	Value
Encabezado	PortableDeviceTypes.h
Biblioteca	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceValues (Interfaz)

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue