Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbiedApplication::UpdateStatus

接続されているロビー クライアントの状態を更新する。

HRESULT UpdateStatus(
const DPNHANDLE hConnection,
const DWORD dwStatus,
const DWORD dwFlags
);

パラメータ

hConnection
ロビー クライアントを指定する DPNHANDLE 型の変数。次のフラグも指定できる。
DPLHANDLE_ALLAPPLICATIONS
接続されているすべてのロビー クライアントに状態の更新が送信される。
dwStatus
ロビー クライアントとロビー アプリケーション間の状態を示す次のフラグのいずれかが格納される DWORD 型の変数。
DPLSESSION_CONNECTED
ロビー クライアントとロビー アプリケーションは現在接続されている。
DPLSESSION_COULDNOTCONNECT
ロビー クライアントはロビー アプリケーションに接続できなかった。
DPLSESSION_DISCONNECTED
ロビー クライアントとロビー アプリケーションは現在接続解除されている。
DPLSESSION_TERMINATED
ロビー クライアントとロビー アプリケーションの間の接続は終了した。
DPLSESSION_HOSTMIGRATED
接続に関連付けられたピア オブジェクトは、ホストの移行が行われるセッションに関与する。ローカル クライアントは新規ホストではない。
DPLSESSION_HOSTMIGRATEDHERE
接続に関連付けられたピア オブジェクトは、ホストの移行が行われるセッションに関与する。ローカル クライアントが新規ホストになる。
dwFlags
将来の使用に備えて予約されているので、0 に設定しておく。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_INVALIDHANDLE
DPNERR_INVALIDPARAM

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplobby8.h で宣言。