LINE_REMOVE メッセージ
TAPI LINE_REMOVE メッセージは、回線デバイスの除去 (システムからの削除) をアプリケーションに通知するために送信されます。 一般に、これは PCMCIA デバイスの抽出などの一時的な削除には使用されませんが、TAPI が再初期化された場合にサービス プロバイダーによってデバイスが報告されなくなる永続的な削除に対してのみ使用されます。
-
hDevice
-
予約済み。 0 に設定します。
-
dwCallbackInstance
-
予約済み。 0 に設定します。
-
dwParam1
-
削除された回線デバイスの識別子。
-
dwParam2
-
予約済み。 0 に設定します。
-
dwParam3
-
予約済み。 0 に設定します。
戻り値はありません。
TAPI バージョン 2.0 以降をサポートするアプリケーションには、 LINE_REMOVE メッセージが送信されます。 これにより、デバイスがシステムから削除されたことが通知されます。 アプリケーションが行を開いている場合、 LINE_REMOVE メッセージの前に各行ハンドルに LINE_CLOSE メッセージが表示されます。 このメッセージは、 lineInitializeEx を呼び出した TAPI バージョン 2.0 以降をサポートしているすべてのアプリケーション (その時点で回線デバイスが開かっていないアプリケーションを含む) に送信されます。
古いアプリケーションには、LINEDEVSTATE_REMOVEDを指定する LINE_LINEDEVSTATE メッセージが送信され、その後にLINE_CLOSE メッセージが送信されます。 ただし、 LINE_REMOVE メッセージとは異なり、これらの古いアプリケーションは、削除されたときに行が開いている場合にのみ、これらのメッセージを受信できます。 回線が開かない場合、デバイスにアクセスしようとすると、デバイスが削除されたことを示す唯一のLINEERR_NODEVICE エラーが表示されます。
デバイスが削除されると、デバイス識別子によってデバイスにアクセスしようとすると、LINEERR_NODEVICE エラーが発生します。 TAPI が再起動できるようにすべての TAPI アプリケーションがシャットダウンされた後、TAPI が再初期化されると、削除されたデバイスはデバイス識別子を占有しなくなります。
注意
実装: このLINEERR_NODEVICEを返す TAPI です。サービス プロバイダーから LINE_REMOVE メッセージを受信した後。その回線デバイス識別子を使用して、そのサービス プロバイダーに対してそれ以上の呼び出しは行われません。
要件 | 値 |
---|---|
TAPI バージョン |
TAPI 2.0 以降が必要です |
ヘッダー |
|