IDeviceSpecificProperty::SetValue-Methode (devicetopology.h)
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 |
|---|---|
|
Der Zeiger pvValue ist NULL. |
|
Der Parameter cbValue stimmt nicht mit der erforderlichen Größe des Eigenschaftswerts überein. |
|
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 |