共用方式為

lineGetCountry 函式 (tapi.h)

  • 發行項

lineGetCountry 函式會擷取儲存的撥號規則，以及其他與指定國家/地區、國家/地區清單中的第一個國家/地區或所有國家/地區相關的資訊。

語法

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

參數

dwCountryID

國家/地區標識碼 (不是要取得資訊的國家/地區) 國家/地區代碼。 如果指定值 1，則會取得國家/地區清單中第一個國家/地區的相關信息。 如果指定了 0 值，則會 (取得所有國家/地區的資訊，這可能需要大量的記憶體—20 KB 以上的) 。

dwAPIVersion

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

lpLineCountryList

載入 LINECOUNTRYLIST 結構所在位置的指標。 在呼叫 lineGetCountry之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

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

傳回值

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INIFILECORRUPT、LINEERR_OPERATIONFAILED、LINEERR_INVALCOUNTRYCODE、LINEERR_STRUCTURETOOSMALL LINEERR_INVALPOINTER。

規格需求

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

另請參閱

基本電話語音服務參考

LINECOUNTRYLIST

TAPI 2.2 參考概觀

lineNegotiateAPIVersion