Método IPortableDeviceProperties::GetValues (portabledeviceapi.h)

Artigo
03/15/2023

O método GetValues recupera uma lista de propriedades especificadas de um objeto especificado em um dispositivo.

Sintaxe

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

Parâmetros

[in] pszObjectID

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a ID do objeto a ser consultado. Para especificar o dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] pKeys

Ponteiro para uma interface IPortableDeviceKeyCollection que contém uma ou mais propriedades para consulta. Se for NULL, todas as propriedades serão recuperadas. Consulte Propriedades e Atributos para obter uma lista de propriedades definidas por Dispositivos Portáteis do Windows.

[out] ppValues

Endereço de uma variável que recebe um ponteiro para uma interface IPortableDeviceValues que contém os valores de propriedade solicitados. Eles serão retornados como pares PROPERTYKEY/value, em que o tipo de dados do valor depende da propriedade . Se um valor não puder ser recuperado por algum motivo, o tipo retornado será VT_ERROR e conterá um valor HRESULT que descreve o erro de recuperação. O chamador deve liberar essa interface quando terminar com ela.

Retornar valor

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	Todos os valores de propriedade solicitados foram recuperados.
S_FALSE	Não foi possível recuperar um ou mais valores de propriedade. As propriedades de problema terão um valor HRESULT no parâmetro ppValues recuperado.