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 を使う。