phoneConfigDialog 関数 (tapi.h)

[アーティクル]
03/09/2024

phoneConfigDialog 関数を使用すると、指定した電話デバイスのプロバイダーにモーダルダイアログボックス (アプリケーションの hwndOwner パラメーターにアタッチ) が表示されます。これにより、ユーザーは dwDeviceID で指定された電話デバイスに関連するパラメーターを構成できます。

構文

LONG phoneConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

パラメーター

dwDeviceID

構成する電話デバイスの識別子。

hwndOwner

ダイアログボックスがアタッチされるウィンドウへのハンドル。関数中に作成されたウィンドウに所有者ウィンドウがないことを示す NULL 値を指定できます。

lpszDeviceClass

デバイスクラス名を識別する null で終わる文字列へのポインター。このデバイスクラスを使用すると、アプリケーションは、そのデバイスクラスに適用できる構成情報の特定のサブ画面を選択できます。このパラメーターは省略可能であり、 NULL または空のままにすることができます。この場合、最上位レベルの構成が選択されます。

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。可能な戻り値は次のとおりです。

PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_INUSE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPARAM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_UNINITIALIZED、PHONEERR_NODEVICE。

注釈

lpszDeviceClass パラメーターを使用すると、アプリケーションは、ユーザーが関心のあるデバイスクラスに適用できる構成情報の特定のサブ画面を選択できます。許可される文字列は phoneGetID の場合と同じです。たとえば、電話が wave API をサポートしている場合、 lpszDeviceClass として "wave/in" を渡すと、プロバイダーは特にウェーブに関連するパラメーターを表示します (または、少なくともマルチレベル構成ダイアログボックスチェーン内の対応するポイントから開始するため、関連するパラメーターを検索する必要がなくなります)。

lpszDeviceClass パラメーターは、"tapi/phone"、""、または NULL にして、プロバイダーに電話の最高レベルの構成を表示させる必要があります。