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 |