lineGetAddressCaps 函式 (tapi.h)

發行項
03/02/2024

lineGetAddressCaps 函式會查詢指定線路裝置上的指定位址，以判斷其電話語音功能。

語法

LONG lineGetAddressCaps(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

參數

hLineApp

使用 TAPI 處理應用程式的註冊。

dwDeviceID

包含要查詢之位址的行裝置。

dwAddressID

要查詢其功能之指定行裝置上的位址。位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。

dwAPIVersion

要使用的電話語音 API 版本號碼。高序字包含主要版本號碼;低序字包含次要版本號碼。此數位是由 lineNegotiateAPIVersion取得。

dwExtVersion

要使用的服務提供者特定擴充功能版本號碼。如果未使用任何裝置特定的擴充功能，這個數位可以設定為零。否則，高序字包含主要版本號碼;和低序字包含次要版本號碼。

lpAddressCaps

LINEADDRESSCAPS 類型的可變大小結構的指標。成功完成要求時，此結構會填入位址功能資訊。在呼叫 lineGetAddressCaps之前，應用程式應該設定這個結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

注意如果結構中的大小參數不正確，可能會覆寫數據。如需設定結構大小的詳細資訊，請參閱記憶體配置主題。

傳回值

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONFAILED、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALAPPHANDLE、LINEERR_UNINITIALIZED、LINEERR_INVALPOINTER、LINEERR_OPERATIONUNAVAIL、LINEERR_NODRIVER LINEERR_NODEVICE。