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.

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

TAPI functionParameters and structure fields converted in ANSI version of function
lineAddProviderlpszProviderName
lineBlindTransferlpszDestAddress
lineConfigDialoglpszDeviceClass
lineConfigDialogEditlpszDeviceClass
[!Note]
Application must handle conversion of strings in lpDeviceConfigIn and lpDeviceConfigOut, if directly manipulated.

lineDiallpszDestAddress
lineForwardlpForwardList ( LINEFORWARDLIST)lpCallParams ( LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineGatherDigitslpsDigitslpszTerminationDigits
lineGenerateDigitslpszDigits
lineGetAddressCapslpAddressCaps ( LINEADDRESSCAPS)
lineGetAddressIDlpsAddress
lineGetAddressStatuslpAddressStatus ( LINEADDRESSSTATUS)
lineGetAgentActivityListlpAgentActivityList ( LINEAGENTACTIVITYLIST)
lineGetAgentCapslpAgentCaps ( LINEAGENTCAPS)
  • AgentHandlerInfo
lineGetAgentGroupListlpAgentGroupListI( LINEAGENTGROUPLIST)
lineGetAgentStatuslpAgentStatus ( LINEAGENTSTATUS)
lineGetAppPrioritylpszAppFilenamelpExtensionName
lineGetCallInfolpCallInfo ( LINECALLINFO)
  • CallerID
  • CallerIDName
  • CalledID
  • CalledIDName
  • ConnectID
  • ConnectedIDName
  • RedirectionID
  • RedirectionIDName
  • RedirectingID
  • RedirectingIDName
  • AppName
  • DisplayableAddress
  • CalledParty
  • Comment
lineGetCountrylpLineCountryList ( LINECOUNTRYLIST)
  • CountryList ( LINECOUNTRYENTRY)
  • CountryName
  • SameAreaRule
  • LongDistanceRule
  • InternationalRule
lineGetDevCapslpLineDevCaps ( LINEDEVCAPS)
  • ProviderInfo
  • SwitchInfo
  • LineName
  • TerminalText
  • DeviceClasses
[!Note]
dwStringFormat is obsolete.

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

LineGetIconlpszDeviceClass
lineGetIDlpszDeviceClass
[!Note]
Application must handle conversion of strings in lpDeviceID, if these are directly manipulated.

LineGetLineDevStatuslpLineDevStatus ( LINEDEVSTATUS)
  • AppInfo (LINEAPPINFO)
  • MachineName
  • UserName
  • ModuleFilename
  • FriendlyName
lineGetProviderListlpProviderList ( LINEPROVIDERLIST)
lineGetRequestlpRequestBuffer ( LINEREQMAKECALL
  • szDestAddress
  • szAppName
  • szCalledParty
  • szComment
lineGetTranslateCapslpTranslateCaps ( LINETRANSLATECAPS)
  • CardList ( LINECARDENTRY)
  • CardName
  • SameAreaRule
  • LongDistanceRule
  • InternationalRule
  • LocationList ( LINELOCATIONENTRY
  • LocationName
  • CityCode
  • LocalAccessCode
  • LongDistanceAccessCode
  • TollPrefixList
  • celCallWaiting
lineHandofflpszFileName
lineInitializeExlpszFriendlyAppName
lineMakeCalllpszDestAddresslpCallParams ( LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineOpenlpCallParams ( LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineParklpszDirAddresslpNonDirAddress ( VARSTRING)
  • String
linePickuplpszDestAddresslpszGroupID
linePrepareAddToConferencelpCallParams ( LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineRedirectlpszDestAddress
lineSetAppPrioritylpszAppFilenamelpszExtensionName
lineSetDevConfiglpszDeviceClass
[!Note]
Application must handle conversion of strings in lpDeviceConfig, if these are directly manipulated.

lineSetTollListlpszAddressIn
lineSetupConferencelpCallParams ( LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineSetupTransferlpCallParams ( LINECALLPARAMS)
  • OrigAddress
  • DisplayableAddress
  • CalledParty
  • Comment
  • TargetAddress
  • DeviceClass
  • CallingPartyID
lineTranslateAddresslpszAddressInlpTranslateOutput ( LINETRANSLATEOUTPUT)
  • DialableString
  • DisplayableString
lineTranslateDialoglpszAddressIn
lineUnparklpszDestAddress
phoneConfigDialoglpszDeviceClass
phoneGetButtonInfolpButtonInfo ( PHONEBUTTONINFO)
  • ButtonText
phoneGetDevCapslpPhoneCaps ( PHONECAPS)
  • ProviderInfo
  • PhoneInfo
  • PhoneName
  • Device Classes
[!Note]
dwStringFormat is obsolete.

phoneGetIconlpszDeviceClass
phoneGetIDlpszDeviceClass
[!Note]
Application must handle conversion of strings in lpDeviceID, if these are directly manipulated.

phoneGetStatuslpPhoneStatus ( PHONESTATUS)
  • OwnerName
phoneInitializeExlpszFriendlyAppName
phoneSetButtonInfolpButtonInfo ( PHONEBUTTONINFO)
  • ButtonTest
tapiGetLocationInfolpszCountryCodelpszCityCode
tapiRequestMakeCalllpszDestAddresslpszAppName
lpszCalledParty
lpszComment