Platform SDK: DirectX |
DirectPlay4.GetDPEnumConnections メソッドは、アプリケーションで利用可能な登録済みのサービス プロバイダおよびロビー プロバイダを列挙する。通常は、これらをユーザーに選択を促す形で提示し、選択された接続を DirectPlay4.InitializeConnection メソッドに渡す。
object.GetDPEnumConnections(guid As String, _ flags As CONST_DPENUMCONNECTIONFLAGS) _ As DirectPlayEnumConnections
成功すれば、DirectPlayEnumConnections オブジェクトを返す。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DPERR_CONNECTIONLOST |
DPERR_INVALIDFLAGS |
DPERR_INVALIDPARAMS |
返されるサービス プロバイダとロビー プロバイダの順番は、以降の GetDPEnumConnections の呼び出しと同じになるとは限らない。
列挙された接続がすべて利用可能なわけではない。たとえば、このメソッドは、ユーザーがモデムをインストールしていない場合でも、モデム サービス プロバイダを返す。アプリケーションでは、それぞれの接続に対して DirectPlay4.InitializeConnection メソッドを呼び出し、エラー コードをチェックして、サービス プロバイダが利用可能かどうかを判断することができる。
サービス プロバイダの中には、自らをプライベートなものとして登録できるものがある。これらのサービス プロバイダは、このメソッドでは列挙されない。プライベートなサービス プロバイダを使用するには、それらを GUID によって明示的に参照する必要がある。それには、アプリケーションをロビーから起動するか、または DirectPlay アドレスを作成して、それを InitializeConnection に渡す。