TSPI_phoneGetExtensionID関数 (tspi.h)
TSPI_phoneGetExtensionID関数は、指定された電話デバイスに対してサービス プロバイダーがサポートする拡張機能識別子を取得します。
構文
LONG TSPIAPI TSPI_phoneGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPPHONEEXTENSIONID lpExtensionID
);
パラメーター
dwDeviceID
照会する電話デバイス。
dwTSPIVersion
TSPI_phoneNegotiateTSPIVersionを使用してこのデバイスに対してネゴシエートされるインターフェイスのバージョン番号を指定します。 この関数は、このバージョン レベルのインターフェイス仕様に従って動作します。
lpExtensionID
PHONEEXTENSIONID 型の構造体へのポインター。 サービス プロバイダーがプロバイダー固有の拡張機能をサポートしている場合は、この構造体にこれらの拡張機能の拡張機能識別子が入力されます。 サービス プロバイダーが拡張機能をサポートしていない場合は、この構造体にゼロがすべて格納されます。 all-zeros 値はサービス プロバイダーが拡張機能をサポートしていないことを示すために使用されるため、すべてのゼロの拡張識別子は有効な拡張識別子ではありません。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NODRIVER、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL。
注釈
この関数は通常、 phoneNegotiateAPIVersion 関数を呼び出すアプリケーションに応答して TAPI によって呼び出されます。 サービス プロバイダーによって返される結果は、後続の TSPI_phoneNegotiateExtVersion の呼び出しで使用するのに適 している必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |