IUPnPEventSink::OnStateChanged method (upnphost.h)

The OnStateChanged method sends an event to the device host with the list of DISPIDs of the state variables that have changed. The device host must query the service object to obtain the new value for each state variable that has changed.

This method is unavailable to Visual Basic developers, and those using other languages that do not support native arrays. These developers must use OnStateChangedSafe instead.

Syntax

HRESULT OnStateChanged(
  [in] DWORD     cChanges,
  [in] DISPID [] rgdispidChanges
);

Parameters

[in] cChanges

Specifies the number of variables in rgdispidChanges. The value indicates the number of variables whose values have changed.

[in] rgdispidChanges

Contains a list of the DISPIDs of the state variables that have changed. The number of elements in this buffer is specified by cChanges.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes defined in WinError.h.

If cChanges is zero or rgdispidChanges is NULL, E_INVALIDARG is returned.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	upnphost.h
DLL	Upnphost.dll

See also

IUPnPEventSink