TSPI_lineGetExtensionID関数 (tspi.h)

  • [アーティクル]

TSPI_lineGetExtensionID関数は、指定された回線デバイスに対してサービス プロバイダーがサポートする拡張識別子を返します。

構文

LONG TSPIAPI TSPI_lineGetExtensionID(
  DWORD             dwDeviceID,
  DWORD             dwTSPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

パラメーター

dwDeviceID

クエリを実行する回線デバイス。

dwTSPIVersion

TSPI_lineNegotiateTSPIVersionを使用してこのデバイスに対して既にネゴシエートされたインターフェイス バージョン番号。 この関数は、このバージョン レベルのインターフェイス仕様に従って動作します。

lpExtensionID

LINEEXTENSIONID 型の構造体へのポインター。 サービス プロバイダーがプロバイダー固有の拡張機能をサポートしている場合は、この構造体にこれらの拡張機能の拡張機能識別子が入力されます。 サービス プロバイダーが拡張機能をサポートしていない場合は、この構造体にゼロがすべて格納されます。 (したがって、有効な拡張識別子は、すべてのゼロで構成することはできません)。

戻り値

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

LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL。

注釈

この関数は通常、 lineNegotiateAPIVersion 関数を呼び出すアプリケーションに応答して TAPI によって呼び出されます。 サービス プロバイダーによって返される結果は、後続の TSPI_lineNegotiateExtVersion の呼び出しで使用するのに適 している必要があります。 すべてのゼロの拡張識別子は有効な拡張識別子ではありません。これは、all-zeros 値を使用して、サービス プロバイダーが拡張機能をサポートしていないことを示すために使用されるためです。

要件

要件 値
対象プラットフォーム Windows
ヘッダー tspi.h

こちらもご覧ください

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion