phoneSetData 関数 (tapi.h)

  • [アーティクル]

phoneSetData 関数は、指定したバッファー内の情報を、選択したデータ識別子で開いている電話デバイスにダウンロードします。

構文

LONG phoneSetData(
  HPHONE       hPhone,
  DWORD        dwDataID,
  LPVOID const lpData,
  DWORD        dwSize
);

パラメーター

hPhone

開いている電話デバイスにハンドルします。 アプリケーションは電話の所有者である必要があります。

dwDataID

電話デバイス内のバッファーをダウンロードする場所。

lpData

データのダウンロード元となるメモリの場所へのポインター。

dwSize

バッファーのサイズ (バイト単位)。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。 対応するPHONE_REPLY メッセージの dwParam2 パラメーターは、関数が成功した場合は 0、エラーが発生した場合は負のエラー番号です。 可能な戻り値は次のとおりです。

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOTOWNER、PHONEERR_NOMEM、PHONEERR_INVALDATAID、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPOINTER、PHONEERR_UNINITIALIZED。

解説

phoneSetData 関数は、lpData から電話デバイスに最大 dwSize バイトをダウンロードします。 データの形式、電話デバイスに対する意味、およびデータ識別子の意味は、サービス プロバイダー固有です。 バッファー内のデータまたはデータ識別子の選択は、電話デバイスへのコマンドとして機能する場合があります。

要件

   
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

関連項目

PHONE_REPLY

補助電話サービス機能

TAPI 2.2 リファレンスの概要