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 が 0 または rgdispidChanges が NULL の場合は、E_INVALIDARGが返されます。