Platform SDK: DirectX

DirectPlay4.CancelMessage

DirectPlay4.CancelMessage メソッドは、送信キュー内の特定のメッセージまたはすべてのメッセージをキャンセルする。CancelMessage は、非同期メッセージにのみ適用される。特定のメッセージをキャンセルするには、アプリケーションで DirectPlay4.SendEx メソッドによって返されるメッセージ ID を取得し、それを保存する必要がある。

既にメッセージ キューを離れていて、部分的に送信されるメッセージは、キャンセルすることができない。グループに送信されたメッセージは、グループの最低 1 人のメンバに送信された後では、キャンセルすることができない。

object.CancelMessage(msgid As Long) 

パラメータ

object
DirectPlay4 オブジェクトを表すオブジェクト式。
msgid
キャンセルするメッセージの ID。この ID は、DirectPlay4.SendEx を使用してメッセージが送信されたときに返される。すべてのメッセージをキャンセルするには、0 を指定する。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DPERR_CANCELFAILED
DPERR_INVALIDFLAGS
DPERR_INVALIDPARAMS
DPERR_UNKNOWNMESSAGE
DPERR_UNSUPPORTED

参照

DirectPlay4.CancelPriorityDirectPlay4.Send