Platform SDK: DirectX

DirectPlay4.InitializeConnection

DirectPlay4.InitializeConnection メソッドは、DirectPlay 接続を初期化する。使用するサービス プロバイダ、サーバーのネットワーク アドレス、セッションの GUID など、接続に関するすべての情報は、addr パラメータを介して渡される。

object.InitializeConnection(addr As DirectPlayAddress) 

パラメータ

object
DirectPlay4 オブジェクトを表すオブジェクト式。
addr
初期化する接続に関するすべての情報へのアクセスを提供する DirectPlayAddress オブジェクト。「注意」を参照すること。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DPERR_ALREADYINITIALIZED
DPERR_INVALIDFLAGS
DPERR_INVALIDPARAMS
DPERR_UNAVAILABLE

このメソッドは、このオブジェクトに対して、InitializeConnection が既に呼び出されている場合は、DPERR_ALREADYINITIALIZED を返す。サービス プロバイダを初期化できなかった場合は、DPERR_UNAVAILABLE を返す。この状態は、当該のサービス プロバイダを利用するための必要なリソースが存在しない場合 (たとえば、TCP/IP スタックが存在しない場合など) に発生する可能性がある。

注意

このメソッドに渡される addr パラメータは、DirectPlay4.GetDPEnumConnections メソッドから取得することができる。または、DirectPlayLobby3 のアドレス作成メソッドのいずれかを使用して、このパラメータを直接作成することもできる。

このメソッドは、適切なサービス プロバイダをロードして、初期化する。addr パラメータは、サービス プロバイダに渡される。サービス プロバイダは、関連する情報を取り出して保存する。この情報は、DirectPlay4.GetDPEnumSessions メソッドまたは DirectPlay4.Open メソッドを呼び出すときに使用される。これにより、サービス プロバイダが同じ情報を要求するダイアログ ボックスを表示しないようにする。

参照

DirectPlayAddress