lineGetTranslateCaps 函式 (tapi.h)

  • 發行項

lineGetTranslateCaps函式會傳回位址轉譯功能。

語法

LONG lineGetTranslateCaps(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

參數

hLineApp

lineInitializeEx函式所傳回的控制碼。 如果應用程式尚未呼叫 lineInitializeEx 函式，此參數可以是零。

注意 TAPI 1.4 應用程式必須將此參數設定為有效的 hLineApp 控制碼，如 lineInitialize 函式所傳回。
 

dwAPIVersion

應用程式支援的最高 TAPI 版本 (不一定是某些特定線路裝置上 lineNegotiateAPIVersion 所交涉的值) 。

lpTranslateCaps

載入 LINETRANSLATECAPS結構之位置的指標。 在呼叫 lineGetTranslateCaps之前，應用程式必須設定這個結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回信息的記憶體數量。

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

傳回值

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INIFILECORRUPT、LINEERR_OPERATIONFAILED、LINEERR_INVALAPPHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NODRIVER。

規格需求

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

另請參閱

基本電話語音服務參考

LINETRANSLATECAPS

TAPI 2.2 參考概觀

lineInitializeEx

lineNegotiateAPIVersion