IUPnPEventSink::OnStateChanged-Methode (upnphost.h)
Die OnStateChanged-Methode sendet ein Ereignis mit der Liste der DISPIDs der geänderten Zustandsvariablen an den Gerätehost. Der Gerätehost muss das Dienstobjekt abfragen, um den neuen Wert für jede geänderte Zustandsvariable abzurufen.
Diese Methode ist für Visual Basic-Entwickler und benutzer, die andere Sprachen verwenden, die keine nativen Arrays unterstützen, nicht verfügbar. Diese Entwickler müssen stattdessen OnStateChangedSafe verwenden.
Syntax
HRESULT OnStateChanged(
[in] DWORD cChanges,
[in] DISPID [] rgdispidChanges
);
Parameter
[in] cChanges
Gibt die Anzahl der Variablen in rgdispidChanges an. Der -Wert gibt die Anzahl der Variablen an, deren Werte sich geändert haben.
[in] rgdispidChanges
Enthält eine Liste der DISPIDs der Zustandsvariablen, die geändert wurden. Die Anzahl der Elemente in diesem Puffer wird durch cChanges angegeben.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der com-Fehlercodes zurück, die in WinError.h definiert sind.
Wenn cChanges null oder rgdispidChangesNULL ist, wird E_INVALIDARG zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnphost.h |
| DLL | Upnphost.dll |