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

こちらもご覧ください

PHONEEXTENSIONID

TSPI_phoneNegotiateExtVersion

TSPI_phoneNegotiateTSPIVersion