Método IPortableDeviceValues::GetValue (portabledevicetypes.h)

Artigo
02/26/2024

A interface GetValue recupera um valor PROPVARIANT especificado por uma chave.

Sintaxe

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

Parâmetros

[in] key

Uma chave REFPROPERTYKEY que especifica o item a ser recuperado.

[out] pValue

Um ponteiro para o valor PROPVARIANT recuperado. O chamador deve liberar a memória chamando PropVariantClear quando a chamada for concluída.

Retornar valor

O método retorna um HRESULT. Os valores retornados possíveis são mostrados 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

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 verificação de tipo adicional.

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.