PHONEERR_定数

[アーティクル]
09/22/2022

これは、電話デバイスで操作を呼び出すときに実装が返すことができるエラーコードの一覧です。各関数が返すことができるエラーコードを特定するには、個々の関数の説明を参照してください。

PHONEERR_ALLOCATED

指定されたリソースは既に割り当てられています。

PHONEERR_BADDEVICEID

指定されたデバイス識別子が無効であるか、範囲外です。

PHONEERR_DISCONNECTED

呼び出しが切断されました。

PHONEERR_INCOMPATIBLEAPIVERSION

アプリケーションは、テレフォニー API 実装または対応するサービスプロバイダーでサポートできない API バージョンまたはバージョン範囲を要求しました。

PHONEERR_INCOMPATIBLEEXTVERSION

アプリケーションが、サービスプロバイダーでサポートできない拡張機能のバージョンまたはバージョン範囲を要求しました。

PHONEERR_INIFILECORRUPT

Telephon.ini ファイル内の内部不整合や書式設定の問題のため、TAPI では読み取りおよび理解できません。

PHONEERR_INUSE

デバイスは現在使用中です。デバイスを構成できません。

PHONEERR_INVALAPPHANDLE

アプリケーションで指定された使用ハンドルまたは登録ハンドルが無効です。

PHONEERR_INVALAPPNAME

指定されたアプリケーション名が無効です。アプリケーション名がアプリケーションによって指定されている場合、文字列には表示不可能な文字が含まれていないため、 NULL で終わると見なされます。

PHONEERR_INVALBUTTONLAMPID

指定されたボタン/ランプ識別子が範囲外であるか、無効です。

PHONEERR_INVALBUTTONMODE

ボタンモードパラメーターが無効です。

PHONEERR_INVALBUTTONSTATE

ボタン状態パラメーターが無効です。

PHONEERR_INVALDATAID

指定されたデータ識別子が無効です。

PHONEERR_INVALDEVICECLASS

指定された電話は、指定されたデバイスクラスをサポートしていません。

PHONEERR_INVALEXTVERSION

サービスプロバイダー拡張機能のバージョン番号が無効です。

PHONEERR_INVALHOOKSWITCHDEV

hookswitch デバイスパラメーターが無効です。

PHONEERR_INVALHOOKSWITCHMODE

hookswitch モードパラメーターが無効です。

PHONEERR_INVALLAMPMODE

指定されたランプモードパラメーターが無効です。

PHONEERR_INVALPARAM

行または列の値やウィンドウハンドルなどのパラメーターが無効であるか、範囲外です。

PHONEERR_INVALPHONEHANDLE

指定されたデバイスハンドルが無効です。

PHONEERR_INVALPHONESTATE

電話デバイスが、要求された操作に対して有効な状態ではありません。

PHONEERR_INVALPOINTER

指定したポインターパラメーターの 1 つ以上が無効です。

PHONEERR_INVALPRIVILEGE

dwPrivilege パラメーターが無効です。

PHONEERR_INVALRINGMODE

リングモードパラメーターが無効です。

PHONEERR_NODEVICE

TAPI が最後に初期化された後に関連付けられているデバイスがシステムから削除されたか、初期化時に検出されなかった方法で破損しているため、以前は有効であった指定されたデバイス識別子は受け入れられません。

PHONEERR_NODRIVER

指定されたデバイスの電話サービスプロバイダーは、初期化時に検出されなかった方法で、そのコンポーネントの 1 つが見つからないか破損していることがわかりました。ユーザーは、テレフォニーコントロールパネルを使用して問題を修正することをお勧めします。

PHONEERR_NOMEM

要求された操作を完了するにはメモリが不足しているか、メモリを割り当てたりロックしたりできません。

PHONEERR_NOTOWNER

アプリケーションには、指定された電話デバイスに対する所有者特権がありません。

PHONEERR_OPERATIONFAILED

指定されていない理由で操作が失敗しました。

PHONEERR_OPERATIONUNAVAIL

操作は使用できません。

PHONEERR_REINIT

たとえば、テレフォニーサービスプロバイダーの追加または削除の結果として TAPI の再初期化が要求された場合、最後のアプリケーションが API の使用をシャットダウン (phoneShutdown を使用) するまで、phoneInitialize、phoneInitializeEx、または phoneOpen 要求は拒否されます。この時点で、新しい構成が有効になり、アプリケーションで phoneInitializeEx または phoneInitializeEx の呼び出しが再度許可されます。

PHONEERR_REQUESTOVERRUN

未処理の電話要求の最大数を超えました。

PHONEERR_RESOURCEUNAVAIL

リソースのオーバーコミットのため、操作を完了できません。

PHONEERR_STRUCTURETOOSMALL

指定された電話のキャップ構造が小さすぎます。

PHONEERR_UNINITIALIZED

この操作は、phoneInitialize、phoneInitializeEx というアプリケーションの前に呼び出されました。

解説

0xFFFFFFFFで0xC0000000される値は、デバイス固有の拡張機能で使用できます。0xBFFFFFFFによって0x80000000される値は予約されています。0x7FFFFFFFを介した0x00000000は、要求識別子として使用されます。

アプリケーションで、特に処理しないエラーが返された場合 (デバイス固有の拡張機能によって定義されたエラーなど)、エラーは (不特定の理由で) PHONEERR_OPERATIONFAILEDとして扱う必要があります。

必要条件

要件	値
TAPI バージョン	TAPI 2.0 以降が必要です
Header	Tapi.h

こちらもご覧ください

phoneInitialize
phoneInitializeEx
phoneOpen
phoneShutdown