lineGetAddressIDW 関数 (tapi.h)
lineGetAddressID 関数は、指定した行の別の形式でアドレスに関連付けられているアドレス識別子を返します。
構文
LONG lineGetAddressIDW(
HLINE hLine,
LPDWORD lpdwAddressID,
DWORD dwAddressMode,
LPCWSTR lpsAddress,
DWORD dwSize
);
パラメーター
hLine
開線デバイスへのハンドル。
lpdwAddressID
アドレス識別子が返される DWORDサイズのメモリ位置へのポインター。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード間で一定のままです。
dwAddressMode
lpsAddressに含まれるアドレスのアドレス モード。 このパラメーターは、LINEADDRESSMODE_ 定数の 1 つだけを使用します。 LINEADDRESSMODE_DIALABLEADDRを指定する必要があります。
lpsAddress
指定された回線デバイスに割り当てられたアドレスを保持するデータ構造へのポインター。 アドレスの形式は、dwAddressMode
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 つの回線に複数のアドレスが割り当てられている環境では、電話番号を使用することが実用的です。
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGetAddressID を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
lineMakeCall を