Método IDeviceSpecificProperty::SetValue (devicetopology.h)
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 |
---|---|
|
El puntero pvValue es NULL. |
|
El parámetro cbValue no coincide con el tamaño necesario del valor de propiedad. |
|
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 |