lineGetAddressID 関数 (tapi.h)

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

lineGetAddressID 関数は、指定した行の別の形式でアドレスに関連付けられているアドレス識別子を返します。

構文

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

パラメーター

hLine

開線デバイスへのハンドル。

lpdwAddressID

アドレス識別子が返される DWORD サイズのメモリ位置へのポインター。アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティングシステムのアップグレード間で一定のままです。

dwAddressMode

lpsAddress に含まれるアドレスのアドレスモード。このパラメーターは、 LINEADDRESSMODE_定数の 1 つだけを使用します。 LINEADDRESSMODE_DIALABLEADDRを指定する必要があります。

lpsAddress

指定した回線デバイスに割り当てられたアドレスを保持するデータ構造へのポインター。アドレスの形式は dwAddressMode によって決まります。有効な値はLINEADDRESSMODE_DIALABLEADDRだけなので、 lpsAddress は共通のダイヤル可能な番号形式を使用し、null で終了します。

dwSize

lpsAddress に含まれるアドレスのサイズ (バイト単位)。文字列のサイズには、null 終端記号を含める必要があります。

戻り値

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALADDRESS、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

注釈

lineGetAddressID 関数は、回線デバイスに割り当てられた電話番号 (アドレス) を、0 の範囲の dwAddressID に、行のデバイス機能で返されたアドレスから 1 を引いたアドレスの数にマップするために使用されます。 lineMakeCall 関数を使用すると、アプリケーションは行ハンドルと行のアドレスを指定して呼び出しを行うことができます。アドレスは、 dwAddressID、電話番号、またはデバイス固有の名前または識別子として指定できます。 1 つの回線に複数のアドレスが割り当てられている環境では、電話番号を使用することが実用的な場合があります。

メモ LINEADDRESSMODE_ADDRESSID は、lineGetAddressID では使用できません。