Metodo IDeviceSpecificProperty::SetValue (devicetopology.h)

Il metodo SetValue imposta il valore della proprietà specifica del dispositivo.

Sintassi

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

Parametri

[in] pvValue

Puntatore al nuovo valore per la proprietà specifica del dispositivo.

[in] cbValue

Dimensioni in byte del valore della proprietà specifica del dispositivo.

[in] pguidEventContext

Valore di contesto per il metodo IControlChangeNotify::OnNotify . Questo parametro punta a un GUID di contesto evento. Se la chiamata SetValue modifica lo stato del controllo, tutti i client che hanno registrato interfacce IControlChangeNotify con tale controllo ricevono notifiche. Nell'implementazione del metodo OnNotify , un client può esaminare il GUID del contesto evento per individuare se è l'origine dell'evento control-change o di un altro client. Se il chiamante fornisce un puntatore NULL per questo parametro, il metodo di notifica del client riceve un puntatore di contesto NULL .

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito	Descrizione
E_POINTER	Il puntatore pvValue è NULL.
E_INVALIDARG	Il parametro cbValue non corrisponde alle dimensioni necessarie del valore della proprietà.
E_OUTOFMEMORY	Memoria insufficiente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfaccia IDeviceSpecificProperty