lineGetAddressID 関数 (tapi.h)
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 つの回線に複数のアドレスが割り当てられている環境では、電話番号を使用することが実用的な場合があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | tapi.h |
Library | Tapi32.lib |
[DLL] | Tapi32.dll |