lineGetLineDevStatus 関数 (tapi.h)

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

lineGetLineDevStatus 関数を使用すると、アプリケーションは、指定されたオープンラインデバイスの現在の状態を照会できます。

構文

LONG lineGetLineDevStatus(
  HLINE           hLine,
  LPLINEDEVSTATUS lpLineDevStatus
);

パラメーター

hLine

クエリを実行するオープンラインデバイスを処理します。

lpLineDevStatus

LINEDEVSTATUS 型の可変サイズのデータ構造へのポインター。要求が正常に完了すると、この構造体には回線のデバイスの状態が入力されます。 lineGetLineDevStatus を呼び出す前に、アプリケーションは、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示す必要があります。

戻り値

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

LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL。

注釈

アプリケーションでは 、lineGetLineDevStatus を使用して、現在の行の状態を回線デバイスに照会します。この状態情報は、回線デバイス上のすべてのアドレスにグローバルに適用されます。 lineGetAddressStatus を使用して、行の特定のアドレスに関する状態情報を確認します。