Método IDeviceSpecificProperty::SetValue (devicetopology.h)

  • Artículo

El método SetValue establece el valor de la propiedad específica del dispositivo.

Sintaxis

HRESULT SetValue(
  [in] void    *pvValue,
  [in] DWORD   cbValue,
  [in] LPCGUID pguidEventContext
);

Parámetros

[in] pvValue

Puntero al nuevo valor de la propiedad específica del dispositivo.

[in] cbValue

Tamaño en bytes del valor de propiedad específico del dispositivo.

[in] pguidEventContext

Valor de contexto del método IControlChangeNotify::OnNotify . Este parámetro apunta a un GUID de contexto de evento. Si la llamada a SetValue cambia el estado del control, todos los clientes que han registrado interfaces IControlChangeNotify con ese control reciben notificaciones. En su implementación del método OnNotify , un cliente puede inspeccionar el GUID de contexto de evento para detectar si es el origen del evento de cambio de control u otro cliente. Si el autor de la llamada proporciona un puntero NULL para este parámetro, el método de notificación del cliente recibe un puntero de contexto NULL .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_POINTER
 El puntero pvValue es NULL.
E_INVALIDARG
 El parámetro cbValue no coincide con el tamaño necesario del valor de propiedad.
E_OUTOFMEMORY
 Memoria insuficiente

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado devicetopology.h

Consulte también

IDeviceSpecificProperty (Interfaz)