Platform SDK: DirectX |
DirectPlay4.InitializeConnection メソッドは、DirectPlay 接続を初期化する。使用するサービス プロバイダ、サーバーのネットワーク アドレス、セッションの GUID など、接続に関するすべての情報は、addr パラメータを介して渡される。
object.InitializeConnection(addr As 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 メソッドを呼び出すときに使用される。これにより、サービス プロバイダが同じ情報を要求するダイアログ ボックスを表示しないようにする。