Método IPortableDeviceManager::GetDeviceProperty (portabledeviceapi.h)

Recupera um valor de propriedade armazenado pelo dispositivo no computador. (Essas não são propriedades padrão definidas por Dispositivos Portáteis do Windows.)

Sintaxe

HRESULT GetDeviceProperty(
  [in]      LPCWSTR pszPnPDeviceID,
  [in]      LPCWSTR pszDevicePropertyName,
  [in, out] BYTE    *pData,
  [in, out] DWORD   *pcbData,
  [in, out] DWORD   *pdwType
);

Parâmetros

[in] pszPnPDeviceID

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a ID de Plug and Play do dispositivo. Você pode recuperar uma lista de nomes de Plug and Play de todos os dispositivos conectados ao computador chamando GetDevices.

[in] pszDevicePropertyName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da propriedade a ser solicitada. Esses são nomes de propriedade personalizados definidos por um fabricante de dispositivo.

[in, out] pData

Um buffer alocado pelo chamador para armazenar os dados recuperados. Para obter o tamanho necessário, chame esse método com esse parâmetro definido como NULL e pcbData definido como zero e o tamanho necessário será recuperado em pcbData. Essa chamada também retornará um erro que pode ser ignorado. Confira Valores retornados.

[in, out] pcbData

O tamanho do buffer alocado ou retornado por pData, em bytes.

[in, out] pdwType

Uma constante que descreve o tipo de dados retornados no pData. Os valores para esse parâmetro são os mesmos tipos usados para descrever o parâmetro lpType da função Do SDK da Plataforma RegQueryValueEx.

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	O método foi bem-sucedido.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	O buffer fornecido não é grande o suficiente para manter os dados solicitados. (Esse resultado sempre é retornado quando pData é NULL. Você poderá ignorar esse resultado se estiver chamando o método para recuperar o tamanho do buffer necessário. Confira a descrição do parâmetro pData .)
E_POINTER	Pelo menos um dos argumentos necessários era um ponteiro NULL .

Comentários

Esses valores de propriedade são armazenados na instalação do dispositivo ou armazenados por um dispositivo durante a operação para que possam ser persistidos entre sessões de conexão. Um aplicativo deve saber o nome exato da propriedade , que é especificada pelo próprio dispositivo; portanto, esse método destina-se a ser usado por desenvolvedores de dispositivos que estão criando seus próprios aplicativos.

Para obter as propriedades dispositivos portáteis do Windows do objeto de dispositivo, chame IPortableDeviceProperties::GetValues e especifique o objeto de dispositivo com WPD_DEVICE_OBJECT_ID.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceManager Interface

IPortableDeviceManager::GetDevices