This topic has not yet been rated - Rate this topic

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 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 directly manipulated.
lineDial	lpszDestAddress
lineForward	lpForwardList ( LINEFORWARDLIST) ForwardList ( LINEFORWARD) CallerAddress DestAddress lpCallParams ( LINECALLPARAMS) OrigAddress DisplayableAddress CalledParty Comment TargetAddress DeviceClass CallingPartyID
lineGatherDigits	lpsDigits lpszTerminationDigits
lineGenerateDigits	lpszDigits
lineGetAddressCaps	lpAddressCaps ( LINEADDRESSCAPS) Address CompletionMsgText DeviceClasses CallTreatmentList ( LINECALLTREATMENTENTRY) CallTreatmentName
lineGetAddressID	lpsAddress
lineGetAddressStatus	lpAddressStatus ( LINEADDRESSSTATUS) Forward ( LINEFORWARD) CallerAddress DestAddress
lineGetAgentActivityList	lpAgentActivityList ( LINEAGENTACTIVITYLIST) List ( LINEAGENTACTIVITYENTRY) Name
lineGetAgentCaps	lpAgentCaps ( LINEAGENTCAPS) AgentHandlerInfo
lineGetAgentGroupList	lpAgentGroupListI( LINEAGENTGROUPLIST) List ( LINEAGENTGROUPENTRY) Name
lineGetAgentStatus	lpAgentStatus ( LINEAGENTSTATUS) Activity GroupList ( LINEAGENTGROUPENTRY) Name
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) ProviderList ( LINEPROVIDERENTRY) ProviderFilename
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 Device Classes 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

Send comments about this topic to Microsoft

Build date: 2/3/2012

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ