IUPnPEventSink：：OnStateChanged 方法 (upnphost.h)

OnStateChanged 方法将事件发送到设备主机，其中包含已更改的状态变量的 DISPID 列表。设备主机必须查询服务对象，以获取已更改的每个状态变量的新值。

Visual Basic 开发人员以及使用不支持本机数组的其他语言的开发人员无法使用此方法。这些开发人员必须改用 OnStateChangedSafe 。

语法

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

[in] cChanges

指定 rgdispidChanges 中的变量数。值指示其值已更改的变量数。

[in] rgdispidChanges

包含已更改的状态变量的 DISPID 列表。此缓冲区中的元素数由 cChanges 指定。

如果方法成功，则返回值S_OK。否则，方法将返回 WinError.h 中定义的 COM 错误代码之一。

如果 cChanges 为零或 rgdispidChanges 为 NULL，则返回E_INVALIDARG。