IDirectPlay8LobbiedApplication::UpdateStatus メソッド

IDirectPlay8LobbiedApplication::UpdateStatus メソッド

構文

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

パラメータ

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

戻り値

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

DPNERR_INVALIDHANDLE	指定されたハンドルは無効である。
DPNERR_INVALIDPARAM	メソッドに渡された 1 つ以上のパラメータが無効である。