IDirectPlay8Peer::TerminateSession メソッド
IDirectPlay8Peer::TerminateSession メソッド
現在の Microsoft® DirectPlay® セッションを終了する。
構文
HRESULT TerminateSession(
void *const pvTerminateData,
const DWORD dwTerminateDataSize,
const DWORD dwFlags
);
パラメータ
- pvTerminateData
[in] 終了データへのポインタ。このデータは、DPN_MSGID_TERMINATE_SESSION システム メッセージの pvTerminateData メンバにも送信される。 - dwTerminateDataSize
[in] pvTerminateData パラメータに保持されるデータのサイズ。 - dwFlags
[in] 予約済み。0 でなければならない。
戻り値
注意
このメソッドはホスト プレーヤのみ呼び出すことができる。
このメソッドは、ホストの移行が有効になっていても、ホスト移行をせずにセッションを終了する。ホスト プレーヤのセッションへの接続を閉じ、ホストの移行が実行できるようにするには、代わりに IDirectPlay8Peer::Close を呼び出す。
このメソッドが呼び出されると、セッションの各プレーヤのメッセージ ハンドラに DPN_MSGID_TERMINATE_SESSION が送信される。
プレーヤは DPN_MSGID_TERMINATE_SESSION を受け取った後に IDirectPlay8Peer::Close を呼び出し、IDirectPlay8Peer オブジェクトを未初期化する必要がある。
参照