Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbiedApplication::Initialize

ロビー クライアントの状態の変更に関する通知およびロビー クライアントからのメッセージを受け取るメッセージ ハンドラ関数を登録する。

HRESULT Initialize(
const PVOID pvUserContext,
const PFNDPNMESSAGEHANDLER pfn,
DPNHANDLE *const pdpnhConnection,
const DWORD dwFlags
);

パラメータ

pvUserContext
メッセージ ハンドラの呼び出しで指定される、ユーザー指定のコンテキスト値。ユーザー指定のコンテキスト値は、複数のインターフェイスから共通のメッセージ ハンドラに送信されたメッセージを区別するのに役立つ。
pfn
IDirectPlay8LobbyClient インターフェイスからすべてのメッセージ、および IDirectPlay8LobbiedApplication インターフェイスからセッション変更の通知を取得する PFNDPNMESSAGEHANDLER コールバック関数へのポインタ。
pdpnhConnection
アプリケーションがロビーで起動されたかどうかを検出するために使用する値。アプリケーションがロビーで起動されている場合、このパラメータにはロビー クライアントの接続ハンドルが設定される。プロセスがロビーで起動されていない場合、このパラメータは NULL に設定される。
dwFlags
次のフラグを指定できる。
DPLINITIALIZE_DISABLEPARAMVAL
パラメータ妥当性の検証を無効にする。

戻り値

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

DPNERR_INVALIDFLAGS
DPNERR_INVALIDPARAM

注意

IDirectPlay8LobbiedApplication インターフェイスを取得するには、CoCreateInstance を使用した後にこのメソッドを呼び出す。

ロビーで起動した場合、このメソッドはロビー クライアントとの接続を自動的に確立する。Initialize を呼び出し、ロビーで起動されているのに、ロビー アプリケーション インターフェイスがロビー クライアント プロセスと通信できない場合、Initialize は 4 秒後にタイムアウトする。この場合、Initialize は DPNERR_TIMEDOUT を返すが、成功である。

動作環境

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