戻り値の列挙型

[アーティクル]
04/22/2010

戻り値の列挙型

エラーは負の値によって示され、結合できない。

Microsoft® DirectPlay® のサンプルの多くには、HRESULT 値を DirectPlay エラーの文字列名に変換する GetDirectPlayErrStr 関数が含まれている。開発者は、診断トレースやエラーレポート用に各自のアプリケーションにこのコードをコピーできる。

構文

typedef enum {
    DPNSUCCESS_PENDING,
    DPN_OK,
    DPNERR_ABORTED,
    DPNERR_ADDRESSING,
    DPNERR_ALREADYCONNECTED,
    DPNERR_ALREADYCLOSING,
    DPNERR_ALREADYDISCONNECTING,
    DPNERR_ALREADYINITIALIZED,
    DPNERR_BUFFERTOOSMALL,
    DPNERR_CANNOTCANCEL,
    DPNERR_CANTCREATEGROUP,
    DPNERR_CANTCREATEPLAYER,
    DPNERR_CANTLAUNCHAPPLICATION,
    DPNERR_CONNECTING,
    DPNERR_CONNECTIONLOST,
    DPNERR_DATATOOLARGE,
    DPNERR_DOESNOTEXIST,
    DPNERR_DPNSVRNOTAVAILABLE,
    DPNERR_ENUMQUERYTOOLARGE,
    DPNERR_ENUMRESPONSETOOLARGE,
    DPNERR_EXCEPTION,
    DPNERR_GENERIC,
    DPNERR_GROUPNOTEMPTY,
    DPNERR_HOSTREJECTEDCONNECTION,
    DPNERR_HOSTTERMINATEDSESSION,
    DPNERR_INCOMPLETEADDRESS,
    DPNERR_INVALIDADDRESSFORMAT,
    DPNERR_INVALIDAPPLICATION,
    DPNERR_INVALIDCOMMAND,
    DPNERR_INVALIDDEVICEADDRESS,
    DPNERR_INVALIDFLAGS,
    DPNERR_INVALIDGROUP,
    DPNERR_INVALIDHANDLE,
    DPNERR_INVALIDHOSTADDRESS,
    DPNERR_INVALIDINSTANCE,
    DPNERR_INVALIDINTERFACE,
    DPNERR_INVALIDOBJECT,
    DPNERR_INVALIDPARAM,
    DPNERR_INVALIDPASSWORD,
    DPNERR_INVALIDPLAYER,
    DPNERR_INVALIDPOINTER,
    DPNERR_INVALIDPRIORITY,
    DPNERR_INVALIDSTRING,
    DPNERR_INVALIDURL,
    DPNERR_INVALIDVERSION,
    DPNERR_NOCAPS,
    DPNERR_NOCONNECTION,
    DPNERR_NOHOSTPLAYER,
    DPNERR_NOINTERFACE,
    DPNERR_NORESPONSE,
    DPNERR_NOTALLOWED,
    DPNERR_NOTHOST,
    DPNERR_NOTREADY,
    DPNERR_OUTOFMEMORY,
    DPNERR_PENDING,
    DPNERR_PLAYERALREADYINGROUP,
    DPNERR_PLAYERNOTINGROUP,
    DPNERR_PLAYERLOST,
    DPNERR_PLAYERNOTREACHABLE,
    DPNERR_SESSIONFULL,
    DPNERR_TIMEDOUT,
    DPNERR_UNINITIALIZED,
    DPNERR_UNSUPPORTED,
    DPNERR_USERCANCEL,
    DV_OK,
    DV_FULLDUPLEX,
    DV_HALFDUPLEX,
    DV_PENDING,
    DVERR_BUFFERTOOSMALL,
    DVERR_EXCEPTION,
    DVERR_GENERIC,
    DVERR_INVALIDFLAGS,
    DVERR_INVALIDOBJECT,
    DVERR_INVALIDPARAM,
    DVERR_INVALIDPLAYER,
    DVERR_INVALIDGROUP,
    DVERR_INVALIDHANDLE,
    DVERR_OUTOFMEMORY,
    DVERR_PENDING,
    DVERR_NOTSUPPORTED,
    DVERR_NOINTERFACE,
    DVERR_SESSIONLOST,
    DVERR_NOVOICESESSION,
    DVERR_CONNECTIONLOST,
    DVERR_NOTINITIALIZED,
    DVERR_CONNECTED,
    DVERR_NOTCONNECTED,
    DVERR_CONNECTABORTING,
    DVERR_NOTALLOWED,
    DVERR_INVALIDTARGET,
    DVERR_TRANSPORTNOTHOST,
    DVERR_COMPRESSIONNOTSUPPORTED,
    DVERR_ALREADYPENDING,
    DVERR_ALREADYINITIALIZED,
    DVERR_SOUNDINITFAILURE,
    DVERR_TIMEOUT,
    DVERR_CONNECTABORTED,
    DVERR_NO3DSOUND,
    DVERR_ALREADYBUFFERED,
    DVERR_NOTBUFFERED,
    DVERR_HOSTING,
    DVERR_NOTHOSTING,
    DVERR_INVALIDDEVICE,
    DVERR_RECORDSYSTEMERROR,
    DVERR_PLAYBACKSYSTEMERROR,
    DVERR_SENDERROR,
    DVERR_USERCANCEL,
    DVERR_UNKNOWN,
    DVERR_RUNSETUP,
    DVERR_INCOMPATIBLEVERSION,
    DVERR_INITIALIZED,
    DVERR_INVALIDPOINTER,
    DVERR_NOTRANSPORT,
    DVERR_NOCALLBACK,
    DVERR_TRANSPORTNOTINIT,
    DVERR_TRANSPORTNOSESSION,
    DVERR_TRANSPORTNOPLAYER,
    DP8SIM_OK,
    DP8SIMERR_ALREADYINITIALIZED,
    DP8SIMERR_INVALIDFLAGS,
    DP8SIMERR_INVALIDOBJECT,
    DP8SIMERR_MISMATCHEDVERSION,
    DP8SIMERR_NOTINITIALIZED,
    DP8SIMERR_INVALIDPARAM,
    DP8SIMERR_INVALIDPOINTER
} Return Values;

定数

DPNSUCCESS_PENDING
非同期処理で、キューへの設定が成功するところまで処理が進んだ。
DPN_OK
操作は正常に終了した。この値は S_OK の標準のコンポーネントオブジェクトモデル (COM) 戻り値に等しい。
DPNERR_ABORTED
処理は、完了する前に取り消された。
DPNERR_ADDRESSING
指定されたアドレスが無効である。
DPNERR_ALREADYCONNECTED
オブジェクトは既にセッションに接続されている。
DPNERR_ALREADYCLOSING
セッションでの Close メソッド呼び出しが複数回行われた。
DPNERR_ALREADYDISCONNECTING
クライアントは既にセッションから接続解除している。
DPNERR_ALREADYINITIALIZED
オブジェクトは既に初期化されている。
DPNERR_BUFFERTOOSMALL
指定されたバッファが小さすぎて、要求されたデータを格納できない。
DPNERR_CANNOTCANCEL
処理を取り消すことができなかった。
DPNERR_CANTCREATEGROUP
新しいグループを作成できない。
DPNERR_CANTCREATEPLAYER
新しいプレーヤを作成できない。
DPNERR_CANTLAUNCHAPPLICATION
ロビーは指定されたアプリケーションを起動できない。
DPNERR_CONNECTING
メソッドはネットワークへの接続処理中である。
DPNERR_CONNECTIONLOST
データの送信中にサービスプロバイダ接続がリセットされた。
DPNERR_DATATOOLARGE
アプリケーションデータが、サービスプロバイダの MTU (Maximum Transmission Unit) に対して大きすぎる。
DPNERR_DOESNOTEXIST
要求された要素はアドレスの一部でないか、要求されたアプリケーションのグローバル一意識別子 (GUID) が登録されていない。
DPNERR_DPNSVRNOTAVAILABLE
ポート 6073 は既に使われている。
DPNERR_ENUMQUERYTOOLARGE
指定されたクエリデータが大きすぎる。
DPNERR_ENUMRESPONSETOOLARGE
列挙クエリへの応答が大きすぎる。
DPNERR_EXCEPTION
要求処理時に例外が発生した。
DPNERR_GENERIC
定義されていないエラー条件が発生した。
DPNERR_GROUPNOTEMPTY
指定されたグループが空ではない。
DPNERR_HOSTREJECTEDCONNECTION
DPN_MSGID_INDICATE_CONNECT システムメッセージは、接続要求に対して S_OK 以外の値を返した。
DPNERR_HOSTTERMINATEDSESSION
ピアツーピアセッションのホスト (ホストの移行が可能) がセッションを終了した。
DPNERR_INCOMPLETEADDRESS
指定されたアドレスが不完全である。
DPNERR_INVALIDADDRESSFORMAT
アドレス形式が無効である。
DPNERR_INVALIDAPPLICATION
アプリケーションに指定された GUID が無効である。
DPNERR_INVALIDCOMMAND
指定されたコマンドが無効である。
DPNERR_INVALIDDEVICEADDRESS
ローカルコンピュータまたはアダプタのアドレスが無効である。
DPNERR_INVALIDFLAGS
このメソッドに渡されたフラグは無効である。
DPNERR_INVALIDGROUP
グループ識別子 (ID) は、このゲームセッションに対する有効なグループ ID として認識されていない。
DPNERR_INVALIDHANDLE
指定されたハンドルは無効である。
DPNERR_INVALIDHOSTADDRESS
指定されたリモートアドレスが無効である。
DPNERR_INVALIDINSTANCE
アプリケーションのインスタンスの GUID が無効である。
DPNERR_INVALIDINTERFACE
インターフェイスパラメータが無効である。接続元プレーヤがクライアント/サーバーゲームのクライアントまたはピアツーピアゲームのピアではなかった場合、接続要求にこの値が返される。
DPNERR_INVALIDOBJECT
DirectPlay オブジェクトのポインタは無効である。
DPNERR_INVALIDPARAM
メソッドに渡された 1 つ以上のパラメータが無効である。
DPNERR_INVALIDPASSWORD
パスワードが必要なセッションに参加しようとしたときに、無効なパスワードが指定された。
DPNERR_INVALIDPLAYER
プレーヤ ID が、このゲームセッションに対する有効なプレーヤ ID として認識されていない。
DPNERR_INVALIDPOINTER
パラメータとして指定されたポインタは無効である。
DPNERR_INVALIDPRIORITY
指定された優先順位が、許可されている優先順位の範囲 (0 以上 65535 以下) 外である。
DPNERR_INVALIDSTRING
パラメータとして指定された文字列が無効である。
DPNERR_INVALIDURL
指定された文字列が無効な DirectPlay URL である。
DPNERR_INVALIDVERSION
DirectPlay の無効なバージョンに接続しようとした。
DPNERR_NOCAPS
DirectPlay が使おうとしている通信リンクでは、この機能を使うことができない。
DPNERR_NOCONNECTION
通信リンクが確立されなかった。
DPNERR_NOHOSTPLAYER
現在、セッションのホストとして機能するプレーヤがない。
DPNERR_NOINTERFACE
インターフェイスがサポートされていない。
DPNERR_NORESPONSE
指定されたターゲットから応答がない。
DPNERR_NOTALLOWED
この機能は、このオブジェクトでは許可されていない。
DPNERR_NOTHOST
クライアントがホスト以外のコンピュータに接続しようとした。ホスト以外のコンピュータがアプリケーションの記述を設定しようとした場合にも、このエラー値が返されることがある。
DPNERR_NOTREADY
オブジェクトの使用準備ができていない。
DPNERR_OUTOFMEMORY
要求された処理を実行するには、メモリが不足している。
DPNERR_PENDING
エラーではない。この戻り値は、非同期処理で、キューへの設定が成功するところまで処理が進んだことを示す。SUCCEEDED(DPNERR_PENDING) は TRUE を返す。このエラー値は、DPNERR_SUCCESS に変更されている。すべての新しいアプリケーションでは、DPNERR_SUCCESS を使う必要がある。DPNERR_PENDING は、下位互換性を保つために導入されている。
DPNERR_PLAYERALREADYINGROUP
プレーヤ ID は既にグループに含まれている。
DPNERR_PLAYERNOTINGROUP
プレーヤ ID はグループに含まれていない。
DPNERR_PLAYERLOST
プレーヤは、セッションへの接続を失った。
DPNERR_PLAYERNOTREACHABLE
プレーヤはピアツーピアセッションに参加しようとしたが、そのセッションの少なくとも 1 人の既存のプレーヤが、参加しようとしたプレーヤに接続できない状態である。
DPNERR_SESSIONFULL
セッションに割り当てられているプレーヤの最大数に達したため、ホストまたはサーバーへの接続要求が失敗した。
DPNERR_TIMEDOUT
時間切れのため、処理が完了できなかった。
DPNERR_UNINITIALIZED
要求されたオブジェクトが初期化されていない。
DPNERR_UNSUPPORTED
関数または機能を、この実装やこのサービスプロバイダで使うことができない。
DPNERR_USERCANCEL
ユーザーは処理を取り消した。
DV_OK
要求は正常に終了した。
DV_FULLDUPLEX
サウンドカードは全二重処理が可能である。
DV_HALFDUPLEX
サウンドカードは半二重モードでしか動作しない。
DV_PENDING
非同期処理で、キューへの設定が成功するところまで処理が進んだ。
DVERR_BUFFERTOOSMALL
指定されたバッファが小さすぎて、要求されたデータを格納できない。
DVERR_EXCEPTION
要求処理時に例外が発生した。
DVERR_GENERIC
定義されていないエラー条件が発生した。
DVERR_INVALIDFLAGS
このメソッドに渡されたフラグは無効である。
DVERR_INVALIDOBJECT
DirectPlay オブジェクトのポインタは無効である。
DVERR_INVALIDPARAM
メソッドに渡された 1 つ以上のパラメータが無効である。
DVERR_INVALIDPLAYER
プレーヤ ID が、このゲームセッションに対する有効なプレーヤ ID として認識されていない。
DVERR_INVALIDGROUP
グループ ID が、このゲームセッションに対する有効なグループ ID として認識されていない。
DVERR_INVALIDHANDLE
指定されたハンドルは無効である。
DVERR_OUTOFMEMORY
要求された処理を実行するには、メモリが不足している。
DVERR_PENDING
エラーではない。この戻り値は、非同期処理で、キューへの設定が成功するところまで処理が進んだことを示す。このエラー値は不適切である。この値は DV_PENDING に変更されている。
DVERR_NOTSUPPORTED
処理はサポートされていない。
DVERR_NOINTERFACE
指定されたインターフェイスがサポートされていない。使用した DirectPlay のバージョンが間違っている可能性がある。
DVERR_SESSIONLOST
トランスポートはセッションへの接続を喪失した。
DVERR_NOVOICESESSION
指定されたセッションはボイスセッションではない。
DVERR_CONNECTIONLOST
ボイスセッションへの接続が失われた。
DVERR_NOTINITIALIZED
このメソッドを呼び出す前に、IDirectPlayVoiceClient::Initialize IDirectPlayVoiceClient8::Initialize または IDirectPlayVoiceServer::Initialize IDirectPlayVoiceServer8::Initialize メソッドを呼び出す必要がある。
DVERR_CONNECTED
DirectPlay Voice オブジェクトが接続されている。
DVERR_NOTCONNECTED
DirectPlay Voice オブジェクトが接続されていない。
DVERR_CONNECTABORTING
接続解除中。
DVERR_NOTALLOWED
オブジェクトには、この処理を実行する権限がない。
DVERR_INVALIDTARGET
指定されたターゲットは、このボイスセッションの有効なプレーヤ ID またはグループ ID ではない。
DVERR_TRANSPORTNOTHOST
オブジェクトはボイスセッションのホストではない。
DVERR_COMPRESSIONNOTSUPPORTED
指定された圧縮タイプがローカルコンピュータでサポートされていない。
DVERR_ALREADYPENDING
このタイプの非同期呼び出しは既にペンディング状態になっている。
DVERR_ALREADYINITIALIZED
オブジェクトは既に初期化されている。
DVERR_SOUNDINITFAILURE
サウンドカードの初期化に失敗した。
DVERR_TIMEOUT
指定された時間内に処理を実行できなかった。
DVERR_CONNECTABORTED
接続処理は、完了前に取り消された。
DVERR_NO3DSOUND
ローカルコンピュータでは 3D サウンドをサポートしていない。
DVERR_ALREADYBUFFERED
指定された ID には既にユーザーバッファがある。
DVERR_NOTBUFFERED
指定された ID にはユーザーバッファがない。
DVERR_HOSTING
オブジェクトはセッションのホストである。
DVERR_NOTHOSTING
オブジェクトはセッションのホストではない。
DVERR_INVALIDDEVICE
指定されたデバイスが無効である。
DVERR_RECORDSYSTEMERROR
録音システムにエラーが発生した。
DVERR_PLAYBACKSYSTEMERROR
再生システムにエラーが発生した。
DVERR_SENDERROR
データの送信中にエラーが発生した。
DVERR_USERCANCEL
ユーザーは処理を取り消した。
DVERR_UNKNOWN
不明なエラーが発生した。
DVERR_RUNSETUP
指定されたオーディオ構成はテストされていない。IDirectPlayVoiceTest::CheckAudioSetup メソッドを呼び出すこと。
DVERR_INCOMPATIBLEVERSION
クライアントは、ホストと互換性がないボイスセッションに接続した。
DVERR_INITIALIZED
オブジェクトが既に初期化されているため、Initialize メソッドは失敗した。
DVERR_INVALIDPOINTER
指定されたポインタが無効である。
DVERR_NOTRANSPORT
指定されたオブジェクトは有効なトランスポートではない。
DVERR_NOCALLBACK
コールバック関数が指定されていないため、この処理は実行できない。
DVERR_TRANSPORTNOTINIT
指定されたトランスポートはまだ初期化されていない。
DVERR_TRANSPORTNOSESSION
指定されたトランスポートは有効だが、接続されていないかホストとなっていない。
DVERR_TRANSPORTNOPLAYER
指定されたトランスポートは接続され、ホストとなっているが、ローカルプレーヤが存在しない。
DP8SIM_OK
DP8Sim 制御オブジェクトは正常に初期化された。
DP8SIMERR_ALREADYINITIALIZED
DP8Sim 制御オブジェクトは既に初期化されている。
DP8SIMERR_INVALIDFLAGS
このメソッドに渡されたフラグは無効である。
DP8SIMERR_INVALIDOBJECT
指定した DP8Sim 制御オブジェクトは無効である。
DP8SIMERR_MISMATCHEDVERSION
異なるバージョンの DP8Sim がこのシステムで既に使われている。
DP8SIMERR_NOTINITIALIZED
DP8Sim 制御オブジェクトは初期化されていない。
DP8SIMERR_INVALIDPARAM
メソッドに渡された 1 つ以上のパラメータが無効である。
DP8SIMERR_INVALIDPOINTER
パラメータとして指定されたポインタは無効である。

注意

次の表は、上のエラーコードが適用されるインターフェイスの一覧である。

インターフェイス
IDirectPlay8Address
IDirectPlay8AddressIP
IDirectPlay8Client
IDirectPlay8LobbiedApplication
IDirectPlay8LobbyClient
IDirectPlay8Peer
IDirectPlay8Server
IDirectPlayVoiceClient
IDirectPlayVoiceServer
IDirectPlayVoiceTest
IDP8SimControl

各メソッドが返すエラーコードについては、各メソッドの説明を参照すること。

列挙型の情報

最低限のオペレーティングシステム

Windows 98、Windows 2000、Windows XP

次の方法で共有

戻り値の列挙型

戻り値の列挙型

その他のリソース