Método IWMDMDevice3::SetProperty (mswmdm.h)

Artículo
02/29/2024

El método SetProperty establece una propiedad de dispositivo específica, si se puede escribir.

Sintaxis

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

Parámetros

[in] pwszPropName

Un carácter ancho, nombre de cadena terminada en NULL de la propiedad que se va a establecer. Esto sobrescribe cualquier propiedad existente con el mismo nombre. Una vez que la aplicación ha realizado esta llamada, debe liberar cualquier memoria dinámica mediante PropVariantClear. Se da una lista de constantes de nombre de propiedad estándar en Constantes de metadatos.

[in] pValue

Valor de la propiedad que se va a establecer.

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

Este método establece la propiedad de dispositivo especificada. Para obtener la lista de propiedades de dispositivo admitidas, el cliente debe consultar el método IWMDMDevice3::GetProperty para la propiedad g_wszWMDMSupportedDeviceProperties .

Para obtener la lista de nombres de propiedad de dispositivo, consulte Constantes de metadatos.

Este método es similar al método SetMetadata para los almacenamientos, pero este método solo puede establecer una propiedad a la vez.

No todas las propiedades del dispositivo se pueden establecer.