TSPI_lineSetAppSpecific関数 (tspi.h)

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

TSPI_lineSetAppSpecific関数は、指定した呼び出しの LINECALLINFO 構造体のアプリケーション固有のフィールドを設定します。

構文

LONG TSPIAPI TSPI_lineSetAppSpecific(
  HDRVCALL hdCall,
  DWORD    dwAppSpecific
);

パラメーター

hdCall

アプリケーション固有のフィールドを設定する呼び出しのハンドル。 hdCall の呼び出し状態は任意の状態にすることができます。

dwAppSpecific

呼び出しの LINECALLINFO 構造体の dwAppSpecific メンバーの新しいコンテンツ。この値は、サービスプロバイダーによって解釈されない。このパラメーターは、この関数が呼び出されるときに TAPI によって検証されません。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_OPERATIONUNAVAIL。

注釈

呼び出しごとに存在する LINECALLINFO データ構造内のアプリケーション固有のフィールドは、テレフォニー API またはそのサービスプロバイダーによって解釈されません。その使用法は、アプリケーションによって完全に定義されます。フィールドは、TSPI_lineGetCallInfoによって返される LINECALLINFO レコードから読み取ることができます。ただし、 TSPI_lineSetAppSpecific を使用してフィールドを設定し、変更が他のアプリケーションに表示されるようにする必要があります。このフィールドが変更されると、サービスプロバイダーは 、AppSpecific フィールドが変更されたことを示すLINE_CALLINFO メッセージを送信します。