次の方法で共有

IDirectPlay8Server::GetLocalHostAddress メソッド

  • [アーティクル]

IDirectPlay8Server::GetLocalHostAddress メソッド

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

構文

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

パラメータ

  • prgpAddress
    [out] ローカル ホスト アドレスを指定する IDirectPlay8Address オブジェクトの配列へのポインタのアドレス。これらのオブジェクトは不要になったら解放しなければならない。解放しなかった場合、メモリ リークが発生する。
  • pcAddress
    [in, out] prgpAddress がポイントする配列に保持できるアドレス オブジェクトの最大数。バッファが小さすぎる場合、メソッドは DPNERR_BUFFERTOOSMALL を返し、pcAddress が必要な値に設定される。
  • dwFlags
    [in] 伝送制御プロトコル/インターネット プロトコル (TCP/IP) サービス プロバイダを使うとき、次のフラグを指定できる。このフラグを他のサービス プロバイダと共に使った場合、このメソッドは DPNERR_UNSUPPORTED を返す。
    • DPNGETLOCALHOSTADDRESSES_COMBINED
      すべての聴取アドレスを 1 つの IDirectPlay8Address オブジェクトに結合して返す。

戻り値

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

DPNERR_INVALIDOBJECT Microsoft® DirectPlay® オブジェクトのポインタは無効である。
DPNERR_BUFFERTOOSMALL 指定されたバッファが小さすぎて、要求されたデータを格納できない。
DPNERR_INVALIDPARAM メソッドに渡された 1 つあるいは複数のパラメータが無効である。
DPNERR_INVALIDPOINTER パラメータとして指定されたポインタが無効である。
DPNERR_UNINITIALIZED 要求されたオブジェクトが初期化されていない。
DPNERR_UNSUPPORTED 関数または機能を、この実装やこのサービス プロバイダで使うことができない。

注意

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

DPNGETLOCALHOSTADDRESSES_COMBINED を指定すると、すべての聴取サーバー アドレスを格納したアドレス オブジェクトが返される。たとえば、サーバーは、ネットワーク アドレス変換 (NAT) デバイスの背後にあるか複数のネットワーク カードを搭載する場合に、複数のアドレスを持つことがある。この場合、プレーヤがすべてのアドレスを同時に試行できれば、サーバーへ接続する時間は短縮できる。アプリケーションは結合されたアドレス オブジェクトを接続するプレーヤに渡す独自の機構を提供しなければならない。1 つの方法は、IDirectPlay8Address::GetURLA または IDirectPlay8Address::GetURLW、および IDirectPlay8Address::BuildFromURLA または IDirectPlay8Address::BuildFromURLW を使い、Web ページかロビー機構を用いて渡す文字列を作成することである。