Microsoft DirectX 8.0 (C++)

IDirectPlay8Peer::GetLocalHostAddresses

セッションをホストするために使用されるローカル アドレスを取得する。

HRESULT GetLocalHostAddresses(
IDirectPlay8Address **const prgpAddress,
DWORD *const pcAddress,
const DWORD dwFlags
);

パラメータ

prgpAddress
ローカル ホスト アドレスを指定する IDirectPlay8Address オブジェクトの配列へのポインタ。これらのオブジェクトは不要になったら解放しなければならない。解放しなかった場合、メモリ リークが発生する。
pcAddress
prgpAddress がポイントする配列に返すことができるアドレス オブジェクトの最大数。バッファが小さすぎる場合、このメソッドは DPNERR_BUFFERTOOSMALL を返す。このパラメータには、必要なサイズが設定される。
dwFlags
予約済み。0 に設定しておく。

戻り値

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

DPNERR_BUFFERTOOSMALL
DPNERR_INVALIDOBJECT
DPNERR_INVALIDPARAM
DPNERR_INVALIDPOINTER
DPNERR_UNINITIALIZED
DPNERR_NOTHOST

注意

このメソッドを使用する最も確実な方法は、最初は pcAddress を 0 に設定してこのメソッドを呼び出すことである。メソッドが戻ると、pcAddress が必要な値をポイントする。2 回目にこのメソッドを呼び出すときは、その値を使って情報を取得する。

呼び出し側がセッション ホストでない場合、メソッドは DPNERR_NOTHOST を返す。リモート プレーヤーのアドレスを取得するには、IDirectPlay8Peer::GetPeerAddress を取得する。

動作環境

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