エラー コード
ここでは、DirectPlay クラスのメソッドによって返される値を記述する。各メソッドが返すエラー コードの一覧については、それぞれのメソッドの説明を参照すること。
DirectPlay のエラー定数は、CONST_DPLAYERR 列挙型のメンバである。
- DP_OK
- 要求は正しく完了した。
- DPERR_ABORTED
- 処理は、完了する前にキャンセルされた。
- DPERR_ACCESSDENIED
- セッションが定員に達しているか、または不正なパスワードが指定された。
- DPERR_ACTIVEPLAYERS
- アクティブなプレーヤーが既に存在するため、要求された処理を実行できない。
- DPERR_ALREADYINITIALIZED
- オブジェクトは既に初期化されている。
- DPERR_APPNOTSTARTED
- アプリケーションはまだ開始されていない。
- DPERR_AUTHENTICATIONFAILED
- パスワードまたは身元証明を認証できなかった。
- DPERR_BUFFERTOOLARGE
- データ バッファが大きすぎて格納できない。
- DPERR_BUFFERTOOSMALL
- 指定されたバッファが小さすぎて、要求されたデータを格納できない。
- DPERR_BUSY
- 転送メディアがビジーであるため、メッセージを送信できない。
- DPERR_CANCELFAILED
- メッセージをキャンセルできなかった。おそらくこのメッセージは、グループ内の 1 人以上のメンバに既に送信されたグループ メッセージである。
- DPERR_CANCELLED
- 処理がキャンセルされた。
- DPERR_CANNOTCREATESERVER
- 新しいセッションに対するサーバーを作成できない。
- DPERR_CANTADDPLAYER
- プレーヤーをセッションに追加できない。
- DPERR_CANTCREATEGROUP
- 新しいグループを作成できない。
- DPERR_CANTCREATEPLAYER
- 新しいプレーヤーを作成できない。
- DPERR_CANTCREATEPROCESS
- アプリケーションを開始できない。
- DPERR_CANTCREATESESSION
- 新しいセッションを作成できない。
- DPERR_CANTLOADCAPI
- 身元情報が提供されておらず、暗号化サービスに使用する CryptoAPI パッケージ (CAPI) をロードできない。
- DPERR_CANTLOADSECURITYPACKAGE
- ソフトウェア セキュリティ パッケージをロードできない。
- DPERR_CANTLOADSSPI
- 身元情報が提供されておらず、身元情報を要求する Security Support Provider Interface (SSPI) をロードできない。
- DPERR_CAPSNOTAVAILABLEYET
- DirectPlay オブジェクトの能力が、まだ決められていない。このエラーは、DirectPlay オブジェクトが、ポーリングによって利用可能な帯域幅と遅延時間を判断する接続ソリューションに実装されている場合に発生する。
- DPERR_CONNECTING
- メソッドはネットワークへの接続処理中である。アプリケーションでは、正しく完了したことを示す DP_OK か、または異なるエラーが返されるまで、このメソッドを使い続ける必要がある。
- DPERR_CONNECTIONLOST
- データの送信中に、サービス プロバイダの接続がリセットされた。
- DPERR_ENCRYPTIONFAILED
- 要求された情報を暗号化できなかった。暗号化は、メッセージのプライバシを保護するために利用される。このエラーは、保証セッションでのみ発生する。
- DPERR_EXCEPTION
- 要求を処理しているときに例外が発生した。
- DPERR_GENERIC
- 定義されていないエラー条件が発生した。
- DPERR_INVALIDFLAGS
- このメソッドに渡されたフラグは無効である。
- DPERR_INVALIDGROUP
- グループ ID が、このゲーム セッションに対する有効なグループ ID として認識されていない。
- DPERR_INVALIDINTERFACE
- インターフェイス パラメータが無効である。
- DPERR_INVALIDOBJECT
- DirectPlay オブジェクトが無効である。
- DPERR_INVALIDPARAMS
- メソッドに渡された 1 つ以上のパラメータが無効である。
- DPERR_INVALIDPASSWORD
- パスワードを要求するセッションに参加するときに、無効なパスワードが提供された。
- DPERR_INVALIDPLAYER
- プレーヤー ID が、このゲーム セッションに対する有効なプレーヤー ID として認識されていない。
- DPERR_INVALIDPRIORITY
- 指定された優先順位が、指定可能な範囲内 (0 〜 65535) ではない。
- DPERR_LOGONDENIED
- 身元証明が要求されているか、身元証明が提示されなかったか、または身元証明が無効であったため、セッションを開くことができなかった。
- DPERR_NOCAPS
- DirectPlay が使用する通信リンクが、この関数に対応していない。
- DPERR_NOCONNECTION
- 通信リンクが確立されていない。
- DPERR_NOINTERFACE
- インターフェイスがサポートされていない。
- DPERR_NOMESSAGES
- 受信キューにメッセージが存在しない。
- DPERR_NONAMESERVERFOUND
- ネーム サーバー (ホスト) が見つからないか、または作成できなかった。プレーヤーの作成にはホストが必要である。
- DPERR_NONEWPLAYERS
- セッションが新しいプレーヤーを受け入れていない。
- DPERR_NOPLAYERS
- セッション内にアクティブなプレーヤーが存在しない。
- DPERR_NOSESSIONS
- 呼び出されたメソッドの対象となるセッションが存在しない。
- DPERR_NOTLOBBIED
- アプリケーションが DirectPlayLobby3.RunApplication メソッドによって開始されていない場合、またはこの DirectPlayLobby オブジェクトに対して DirectPlayLobbyConnection インターフェイスが現在初期化されていない場合に、DirectPlayLobby3.Connect メソッドから返される。
- DPERR_NOTLOGGEDIN
- プレーヤーまたはクライアント アプリケーションがログオンしていないため、動作を実行できない。クライアント アプリケーションがログオンせずに保証メッセージを送信したときに、DirectPlay4.Send メソッドから返される。
- DPERR_OUTOFMEMORY
- 要求された処理を実行するために必要な量のメモリが存在しない。
- DPERR_PENDING
- エラーではない。非同期送信が、正しくキューに入れられるポイントに達したことを示す。詳細については、「SendEx」を参照すること。
- DPERR_PLAYERLOST
- プレーヤーがセッションへの接続を失った。
- DPERR_SENDTOOBIG
- DirectPlay4.Send メソッドによって送信されたメッセージが大きすぎる。
- DPERR_SESSIONLOST
- セッションへの接続が失われた。
- DPERR_SIGNFAILED
- 要求された情報にデジタル署名を追加できない。デジタル署名は、メッセージが本物であることを示すために使用される。
- DPERR_TIMEOUT
- 指定された時間内に処理を完了できなかった。
- DPERR_UNAVAILABLE
- 要求された関数は現在利用できない。
- DPERR_UNINITIALIZED
- 要求されたオブジェクトが初期化されていない。
- DPERR_UNKNOWNAPPLICATION
- 不明なアプリケーションが指定された。
- DPERR_UNKNOWNMESSAGE
- メッセージ ID が有効ではない。キャンセルするメッセージの ID が無効な場合に、DirectPlay4.CancelMessage から返される。
- DPERR_UNSUPPORTED
- 関数または機能が、この実装またはサービス プロバイダでは利用できない。ロビー セッションではないセッションから DirectPlay4.SetGroupConnectionSettings メソッドが呼び出された場合に、返される。また、優先順位またはタイムアウトが設定されていて、これらの機能がサービス プロバイダによってサポートされておらず、DirectPlay プロトコルがオンになっていない場合に、DirectPlay4.SendEx から返される。さらに、送信キューをチェックして、それがサービス プロバイダによってサポートされておらず、DirectPlay プロトコルがオンになっていない場合は、DirectPlay4.GetMessageQueue から返される。
- DPERR_USERCANCEL
- ユーザーが DirectPlay4.Open メソッドの呼び出し中に接続処理をキャンセルした場合、またはユーザーが DirectPlay4.GetDPEnumSessions の呼び出し中に DirectPlay サービス プロバイダのダイアログ ボックスで [キャンセル] をクリックした場合に返される。