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

Artículo
03/05/2024

El método GetProperty recupera una propiedad de dispositivo específica.

Sintaxis

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

Parámetros

[in] pwszPropName

Nombre de la propiedad que se va a recuperar del dispositivo.

[out] pValue

Valor devuelto para la propiedad .

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

Códigos de error COM estándar
Códigos de error de Windows convertidos en valores HRESULT
Códigos de error de windows Media Administrador de dispositivos

Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

La variante a la que pValue apunta se establece en un PROPVARIANT vacío, es decir, su VT se establece en VT_EMPTY.

El proveedor de servicios debe establecer esta variante en el valor de propiedad adecuado para la propiedad pwszPropName.

Si pwszPropName es g_wszWMDMSupportedDeviceProperties, el proveedor de servicios debe devolver una matriz de las propiedades de dispositivo admitidas. En tal caso, el VT de variante debe ser VT_BSTR | VT_ARRAY.

Para obtener una lista de nombres de propiedad de dispositivo estándar, consulte Constantes de metadatos.

Este método es similar a los métodos IMDSPStorage3::GetMetadata e IMDSPStorage4::GetSpecifiedMetadata para almacenamientos, pero este método solo puede obtener una propiedad a la vez.