Functions with Unicode (W) Versions

The following TAPI functions are implemented in Unicode (W) and ANSI (A) versions. In general, the implementation of the ANSI version calls the Unicode version and performs necessary conversions of ANSI parameters and structure fields to and from Unicode; the following table indicates the parameters that are converted.

Applications that explicitly call the generic (neither "W" or "A" suffix) version of a function will execute the ANSI version, for compatibility with previous versions of TAPI.

Note  The entire Telephony Service Provider Interface (TSPI) is Unicode for version 2.0.

In the following table, references to string fields in TAPI structures consist of a portion of the field names. For example, the "Caller Address" in the LINEFORWARD structure is pointed to by a field named dwCallerAddressOffset and delimited by a field named dwCallerAddressSize; in the table, this string is identified simply as CallerAddress.

TAPI Function Parameters and Structure Fields Converted in ANSI Version of Function
lineAddProvider lpszProviderName
lineBlindTransfer lpszDestAddress
lineConfigDialog lpszDeviceClass
lineConfigDialogEdit lpszDeviceClass

Note  Application must handle conversion of strings in lpDeviceConfigIn and lpDeviceConfigOut, if these are directly manipulated.

lineDial lpszDestAddress
lineForward lpForwardList (LINEFORWARDLIST)

lpCallParams (LINECALLPARAMS)

  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineGatherDigits lpsDigits

lpszTerminationDigits

lineGenerateDigits lpszDigits
lineGetAddressCaps lpAddressCaps (LINEADDRESSCAPS)
lineGetAddressID lpsAddress
lineGetAddressStatus lpAddressStatus (LINEADDRESSSTATUS)
lineGetAgentActivityList lpAgentActivityList (LINEAGENTACTIVITYLIST)
lineGetAgentCaps lpAgentCaps (LINEAGENTCAPS)
  • AgentHandlerInfo
lineGetAgentGroupList lpAgentGroupListI(LINEAGENTGROUPLIST)
lineGetAgentStatus lpAgentStatus (LINEAGENTSTATUS)
lineGetAppPriority lpszAppFilename

lpExtensionName

lineGetCallInfo lpCallInfo (LINECALLINFO)
  • CallerID
  • CallerIDName
  • CalledID
  • CalledIDName
  • ConnectID
  • ConnectedIDName
  • RedirectionID
  • RedirectionIDName
  • RedirectingID
  • RedirectingIDName
  • AppName
  • DisplayableAddress
  • CalledParty
  • Comment
lineGetCountry lpLineCountryList (LINECOUNTRYLIST)
  • CountryList (LINECOUNTRYENTRY)
  • CountryName
  • SameAreaRule
  • LongDistanceRule
  • InternationalRule
lineGetDevCaps lpLineDevCaps (LINEDEVCAPS)
  • ProviderInfo
  • SwitchInfo
  • LineName
  • TerminalText
  • DeviceClasses

Note  dwStringFormat is obsolete.

LineGetDevConfig lpszDeviceClass

Note  Application must handle conversion of strings in lpDeviceConfig, if these are directly manipulated.

LineGetIcon lpszDeviceClass
lineGetID lpszDeviceClass

Note  Application must handle conversion of strings in lpDeviceID, if these are directly manipulated.

LineGetLineDevStatus lpLineDevStatus (LINEDEVSTATUS)
  • AppInfo (LINEAPPINFO)
  • MachineName
  • UserName
  • ModuleFilename
  • FriendlyName
lineGetProviderList lpProviderList (LINEPROVIDERLIST)
lineGetRequest lpRequestBuffer (LINEREQMAKECALL
  • szDestAddress
  • szAppName
  • szCalledParty
  • szComment
lineGetTranslateCaps lpTranslateCaps (LINETRANSLATECAPS)
  • CardList (LINECARDENTRY)
  • CardName
  • SameAreaRule
  • LongDistanceRule
  • InternationalRule
  • LocationList (LINELOCATIONENTRY
  • LocationName
  • CityCode
  • LocalAccessCode
  • LongDistanceAccessCode
  • TollPrefixList
  • celCallWaiting
lineHandoff lpszFileName
lineInitializeEx lpszFriendlyAppName
lineMakeCall lpszDestAddress

lpCallParams (LINECALLPARAMS)

  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineOpen lpCallParams (LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
linePark lpszDirAddress

lpNonDirAddress (VARSTRING)

  • String
linePickup lpszDestAddress

lpszGroupID

linePrepareAddToConference lpCallParams (LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineRedirect lpszDestAddress
lineSetAppPriority lpszAppFilename

lpszExtensionName

lineSetDevConfig lpszDeviceClass

Note  Application must handle conversion of strings in lpDeviceConfig, if these are directly manipulated.

lineSetTollList lpszAddressIn
lineSetupConference lpCallParams (LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineSetupTransfer lpCallParams (LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineTranslateAddress lpszAddressIn

lpTranslateOutput (LINETRANSLATEOUTPUT)

  • DialableString
  • DisplayableString
lineTranslateDialog lpszAddressIn
lineUnpark lpszDestAddress
phoneConfigDialog lpszDeviceClass
phoneGetButtonInfo lpButtonInfo (PHONEBUTTONINFO)
  • ButtonText
phoneGetDevCaps lpPhoneCaps (PHONECAPS)
  • ProviderInfo
  • PhoneInfo
  • PhoneName
  • DeviceClasses

Note  dwStringFormat is obsolete.

phoneGetIcon lpszDeviceClass
phoneGetID lpszDeviceClass

Note  Application must handle conversion of strings in lpDeviceID, if these are directly manipulated.

phoneGetStatus lpPhoneStatus (PHONESTATUS)
  • OwnerName
phoneInitializeEx lpszFriendlyAppName
phoneSetButtonInfo lpButtonInfo (PHONEBUTTONINFO)
  • ButtonTest
tapiGetLocationInfo lpszCountryCode

lpszCityCode

tapiRequestMakeCall lpszDestAddress

lpszAppName

lpszCalledParty

lpszComment