Método IMDSPDevice3::GetProperty (mswmdm.h)

Artigo
03/05/2024

O método GetProperty recupera uma propriedade de dispositivo específica.

Sintaxe

HRESULT GetProperty(
  [in]  LPCWSTR     pwszPropName,
  [out] PROPVARIANT *pValue
);

Parâmetros

[in] pwszPropName

Nome da propriedade que está sendo recuperada do dispositivo.

[out] pValue

Valor retornado para a propriedade .

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

Códigos de erro COM padrão
Códigos de erro do Windows convertidos em valores HRESULT
Códigos de erro do Windows Media Gerenciador de Dispositivos

Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

A variante para a qual pValue aponta é definida como um PROPVARIANT vazio, ou seja, sua VT é definida como VT_EMPTY.

O provedor de serviços deve definir essa variante como o valor de propriedade apropriado para a propriedade pwszPropName.

Se pwszPropName for g_wszWMDMSupportedDeviceProperties, o provedor de serviços deverá retornar uma matriz das propriedades do dispositivo com suporte. Nesse caso, a VT da variante deve ser VT_BSTR | VT_ARRAY.

Para obter uma lista de nomes de propriedade de dispositivo padrão, consulte Constantes de metadados.

Esse método é semelhante aos métodos IMDSPStorage3::GetMetadata e IMDSPStorage4::GetSpecifiedMetadata para armazenamentos, mas esse método pode obter apenas uma propriedade por vez.