Méthode IUPnPEventSink ::OnStateChanged (upnphost.h)
La méthode OnStateChanged envoie un événement à l’hôte de l’appareil avec la liste des DISPID des variables d’état qui ont changé. L’hôte de l’appareil doit interroger l’objet de service pour obtenir la nouvelle valeur pour chaque variable d’état qui a changé.
Cette méthode n’est pas disponible pour les développeurs Visual Basic et ceux qui utilisent d’autres langages qui ne prennent pas en charge les tableaux natifs. Ces développeurs doivent utiliser OnStateChangedSafe à la place.
Syntaxe
HRESULT OnStateChanged(
[in] DWORD cChanges,
[in] DISPID [] rgdispidChanges
);
Paramètres
[in] cChanges
Spécifie le nombre de variables dans rgdispidChanges. La valeur indique le nombre de variables dont les valeurs ont changé.
[in] rgdispidChanges
Contient une liste des DISPID des variables d’état qui ont changé. Le nombre d’éléments dans cette mémoire tampon est spécifié par cChanges.
Valeur retournée
Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError.h.
Si cChanges a la valeur zéro ou si rgdispidChanges a la valeur NULL, E_INVALIDARG est retourné.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | upnphost.h |
| DLL | Upnphost.dll |