lineGetAddressCapsW 函式（tapi.h）

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

語法

LONG lineGetAddressCapsW(
  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。