lineGetTranslateCapsA 函式 （tapi.h）

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

語法

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

參數

hLineApp

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

Note 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。

言論

注意

tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetTranslateCaps 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
目標平臺	窗戶
標頭	tapi.h
連結庫	Tapi32.lib
DLL	Tapi32.dll

另請參閱

基本電話語音服務參考

LINETRANSLATECAPS

TAPI 2.2 參考概觀

lineInitializeEx

lineNegotiateAPIVersion