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。