Método IPortableDeviceValues::GetValue

O método GetValue recupera um valor PROPVARIANT especificado por uma chave.

Sintaxe

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

Parâmetros

chave [in]

Uma chave REFPROPERTYKEY que especifica o item a ser recuperado.

pValue [out]

Ponteiro para o valor PROPVARIANT recuperado. O chamador deve liberar a memória chamando PropVariantClear quando terminar com ela.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	A propriedade especificada por key não está na coleção.

Comentários

Quando o VARTYPE para pValue é VT_VECTOR ou VT_UI1, não há suporte para a recuperação de um buffer NULL ou de tamanho zero. Por exemplo, nem pValue.caub.pElems = NULL nem pValue.caub.cElems = 0 são permitidos.

Esse método pode ser usado para recuperar um valor de qualquer tipo da coleção. No entanto, se você souber o tipo de valor com antecedência, use um dos métodos de recuperação especializados dessa interface para evitar a sobrecarga de trabalhar diretamente com valores PROPVARIANT.

Requisitos

Requisito	Valor
parâmetro	PortableDeviceTypes.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceValues Interface

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue