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 |
|---|---|
|
O método foi bem-sucedido. |
|
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 .) |
|
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 |