lineGetAddressStatus 函式 (tapi.h)

  • 發行項

lineGetAddressStatus 函式可讓應用程式查詢其目前狀態的指定位址。

語法

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

參數

hLine

開啟行裝置的句柄。

dwAddressID

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

lpAddressStatus

LINEADDRESSSTATUS 類型的可變大小數據結構的指標。 在呼叫 lineGetAddressStatus之前，應用程式必須設定這個結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

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

傳回值

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

LINEERR_INVALADDRESSID、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_OPERATIONUNAVAIL LINEERR_OPERATIONFAILED。

規格需求

需求 值
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

基本電話語音服務參考

LINEADDRESSSTATUS

TAPI 2.2 參考概觀