Share via

IDeviceSpecificProperty::SetValue-Methode (devicetopology.h)

  • Artikel

Die SetValue-Methode legt den Wert der gerätespezifischen Eigenschaft fest.

Syntax

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

Parameter

[in] pvValue

Zeiger auf den neuen Wert für die gerätespezifische Eigenschaft.

[in] cbValue

Die Größe des gerätespezifischen Eigenschaftswerts in Byte.

[in] pguidEventContext

Kontextwert für die IControlChangeNotify::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetValue-Aufruf den Status des Steuerelements ändert, erhalten alle Clients, die IControlChangeNotify registriert haben, Benachrichtigungen mit diesem Steuerelement. Bei der Implementierung der OnNotify-Methode kann ein Client die Ereigniskontext-GUID untersuchen, um zu ermitteln, ob sie oder ein anderer Client die Quelle des Control-Change-Ereignisses ist. Wenn der Aufrufer einen NULL-Zeiger für diesen Parameter bereitstellt, empfängt die Benachrichtigungsmethode des Clients einen NULL-Kontextzeiger .

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
 Der Zeiger pvValue ist NULL.
E_INVALIDARG
 Der Parameter cbValue stimmt nicht mit der erforderlichen Größe des Eigenschaftswerts überein.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

IDeviceSpecificProperty-Schnittstelle