Platform SDK: DirectX

DirectPlay4.GetDPEnumConnections

DirectPlay4.GetDPEnumConnections メソッドは、アプリケーションで利用可能な登録済みのサービス プロバイダおよびロビー プロバイダを列挙する。通常は、これらをユーザーに選択を促す形で提示し、選択された接続を DirectPlay4.InitializeConnection メソッドに渡す。

object.GetDPEnumConnections(guid As String, _
    flags As CONST_DPENUMCONNECTIONFLAGS) _
    As DirectPlayEnumConnections

パラメータ

object
DirectPlay4 オブジェクトを表すオブジェクト式。
guid
アプリケーションのグローバル ユニーク識別子 (GUID)。このアプリケーションで利用可能なサービス プロバイダとロビー プロバイダだけが返される。"" に設定すると、アプリケーションの GUID に関係なく、すべての接続が列挙される。
flags
列挙される接続のタイプを指定する CONST_DPENUMCONNECTIONFLAGS フラグ。デフォルト (flags = 0) では、DPCONNECTION_DIRECTPLAY と同じ結果が得られる。

戻り値

成功すれば、DirectPlayEnumConnections オブジェクトを返す。

エラー コード

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

DPERR_CONNECTIONLOST
DPERR_INVALIDFLAGS
DPERR_INVALIDPARAMS

注意

返されるサービス プロバイダとロビー プロバイダの順番は、以降の GetDPEnumConnections の呼び出しと同じになるとは限らない。

列挙された接続がすべて利用可能なわけではない。たとえば、このメソッドは、ユーザーがモデムをインストールしていない場合でも、モデム サービス プロバイダを返す。アプリケーションでは、それぞれの接続に対して DirectPlay4.InitializeConnection メソッドを呼び出し、エラー コードをチェックして、サービス プロバイダが利用可能かどうかを判断することができる。

サービス プロバイダの中には、自らをプライベートなものとして登録できるものがある。これらのサービス プロバイダは、このメソッドでは列挙されない。プライベートなサービス プロバイダを使用するには、それらを GUID によって明示的に参照する必要がある。それには、アプリケーションをロビーから起動するか、または DirectPlay アドレスを作成して、それを InitializeConnection に渡す。

参照

GUID の使用