IWSDDeviceHost::SignalEvent メソッド (wsdhost.h)

イベントが発生したことをサブスクライブしているすべてのクライアントに通知します。

構文

HRESULT SignalEvent(
  [in] LPCWSTR             pszServiceId,
  [in] const void          *pBody,
  [in] const WSD_OPERATION *pOperation
);

[in] pszServiceId

イベントを生成するサービスの ID。

[in] pBody

イベントの本文。

[in] pOperation

操作を指定する WSD_OPERATION 構造体への参照。

可能な戻り値には、次のものが含まれますが、これらに限定されません。

リターンコード	説明
S_OK	メソッドが正常に完了しました。
E_FAIL	ホストが起動されていません。 Start を呼び出して、デバイスホストを起動します。
E_INVALIDARG	pszServiceId が NULL、pOperation が NULL、pszServiceId の文字数が WSD_MAX_TEXT_LENGTH (8192) を超えている、pOperation に関連付けられている ResponseType 構造体がない、または pszServiceId で指定されたサービスが pOperation の ResponseType メンバーによって指定されたイベントにサブスクライブされていない。

SignalEvent は、 イベントがすべてのクライアントに送信されるまでブロックします。クライアントは順番に接続されるため、クライアントの応答が遅い場合や到達できない場合、 SignalEvent が長時間ブロックされる可能性があります。