IDirectPlay8Peer::GetPeerAddress メソッド

IDirectPlay8Peer::GetPeerAddress メソッド

セッション内の指定されたリモート プレーヤのアドレスを取得する。

構文

HRESULT GetPeerAddress(      
    const DPNID dpnid,
    IDirectPlay8Address **const pAddress,
    const DWORD dwFlags
);

パラメータ

• dpnid
  [in] プレーヤの識別情報を指定する DPNID 型の変数。
• pAddress
  [out] ピアのアドレスを指定する IDirectPlay8Address オブジェクトへのポインタのアドレス。このオブジェクトは、不要になったら解放しなければならない。
• dwFlags
  [in] 予約済み。0 でなければならない。

戻り値

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

DPNERR_INVALIDOBJECT	Microsoft® DirectPlay® オブジェクトのポインタは無効である。
DPNERR_INVALIDPLAYER	プレーヤ ID が、このゲーム セッションに対する有効なプレーヤ ID として認識されていない。
DPNERR_INVALIDPARAM	メソッドに渡された 1 つ以上のパラメータが無効である。
DPNERR_INVALIDPOINTER	パラメータとして指定されたポインタが無効である。
DPNERR_UNINITIALIZED	要求されたオブジェクトが初期化されていない。

注意

このメソッドを使ってローカル プレーヤのアドレスは取得できない。プレーヤが自分の識別子 (ID) に対してこのメソッドを呼び出すと、DPNERR_INVALIDPLAYER エラー メッセージが返される。

セッションへの接続に使えるアドレスを取得するには、IDirectPlay8Peer::GetLocalHostAddresses を使う。