次の方法で共有


IDirectPlay8LobbyClient::Initialize メソッド

IDirectPlay8LobbyClient::Initialize メソッド

起動したアプリケーションの状態変更に関する通知を受け取るロビー クライアントのコード内のエントリ ポイントを登録する。また、メッセージ ハンドラはロビー アプリケーションからメッセージを受け取る。このメソッドを呼び出してから、このインターフェイスのその他のメソッドを呼び出す必要がある。

構文

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

パラメータ

  • pvUserContext
    [in] メッセージ ハンドラの呼び出しで指定される、ユーザー指定のコンテキスト値へのポインタ。ユーザー指定のコンテキスト値は、複数のインターフェイスから共通のメッセージ ハンドラに送信されたメッセージを区別するのに役立つ。
  • pfn
    [in] IDirectPlay8LobbyClient インターフェイスからすべてのメッセージ、および IDirectPlay8LobbiedApplication インターフェイスからセッション変更の通知を取得する PFNDPNMESSAGEHANDLER コールバック関数へのポインタ。
  • dwFlags
    [in] 次のフラグを指定できる。
    • DPLINITIALIZE_DISABLEPARAMVAL
      パラメータ妥当性の検証を無効にする。

戻り値

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

DPNERR_ALREADYINITIALIZED オブジェクトは既に初期化されている。
DPNERR_INVALIDFLAGS このメソッドに渡されたフラグは無効である。
DPNERR_INVALIDPARAM メソッドに渡された 1 つ以上のパラメータが無効である。
DPNERR_NOTALLOWED この機能は、このオブジェクトでは許可されていない。

注意

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

  各プロセスには IDirectPlay8LobbyClient および IDirectPlay8LobbiedApplication の 1 つのインスタンスのみ実行できる。