次の方法で共有

IDirectPlay8Address::BuildFromDPADDRESS メソッド

  • [アーティクル]

IDirectPlay8Address::BuildFromDPADDRESS メソッド

現在のオブジェクトの内部アドレスに、指定された DirectPlay 4 アドレスに相当する Microsoft® DirectPlay® 8 のアドレスを設定する。このメソッドの目的は、ロビー開発者が古いロビー コードを使って新しい DirectPlay インターフェイスでゲームを起動できるようにすることにある。

このメソッドは、指定されたアドレスのアドレス コンポーネントを列挙し、対応する要素を DirectPlay 8 アドレスに追加する。

構文

HRESULT BuildFromDPADDRESS(      
    LPVOID pvAddress,
    DWORD dwDataSize
);

パラメータ

  • pvAddress
    [in] DirectPlay 8 アドレスのフォーマットに変換される DirectPlay 4 アドレスへのポインタ。
  • dwDataSize
    [in] pvAddress パラメータに保持されるデータのサイズ。

戻り値

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

DPNERR_INVALIDADDRESSFORMAT アドレス形式が無効である。
DPNERR_INVALIDOBJECT DirectPlay オブジェクトのポインタは無効である。
DPNERR_INVALIDPOINTER パラメータとして指定されたポインタが無効である。

注意

このメソッドは DirectPlay 4 アドレスから DirectPlay 8 アドレスを作成する。このメソッドは、新しいアドレスを作成する前に、すべての要素の現行アドレスを消去する。

このメソッドには次の制限がある。

  • モデムを識別するとき、DirectPlay 4 ではモデム名を使っているが、DirectPlay 8 ではグローバル一意識別子 (GUID) を使っているため、このメソッドで DPAID_Modem アドレス要素はマッピングできない。
  • 定義済みの DirectPlay 4 アドレス要素の一部ではない DirectPlay 4 アドレスの要素はエラーになり、戻り値は DPNERR_INVALIDADDRESSFORMAT になる。DirectPlay 4 アドレス要素の詳細なリストについては、DirectPlay 4 のドキュメントの DirectPlay アドレスに関する説明を参照すること。