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)
|
| lineGatherDigits | lpsDigitslpszTerminationDigits |
| lineGenerateDigits | lpszDigits |
| lineGetAddressCaps | lpAddressCaps ( LINEADDRESSCAPS)
|
| lineGetAddressID | lpsAddress |
| lineGetAddressStatus | lpAddressStatus ( LINEADDRESSSTATUS)
|
| lineGetAgentActivityList | lpAgentActivityList ( LINEAGENTACTIVITYLIST)
|
| lineGetAgentCaps | lpAgentCaps ( LINEAGENTCAPS)
|
| lineGetAgentGroupList | lpAgentGroupListI( LINEAGENTGROUPLIST)
|
| lineGetAgentStatus | lpAgentStatus ( LINEAGENTSTATUS)
|
| lineGetAppPriority | lpszAppFilenamelpExtensionName |
| lineGetCallInfo | lpCallInfo ( LINECALLINFO)
|
| lineGetCountry | lpLineCountryList ( LINECOUNTRYLIST)
|
| 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)
|
| lineGetProviderList | lpProviderList ( LINEPROVIDERLIST)
|
| lineGetRequest | lpRequestBuffer ( LINEREQMAKECALL
|
| lineGetTranslateCaps | lpTranslateCaps ( LINETRANSLATECAPS)
|
| lineHandoff | lpszFileName |
| lineInitializeEx | lpszFriendlyAppName |
| lineMakeCall | lpszDestAddresslpCallParams ( LINECALLPARAMS)
|
| lineOpen | lpCallParams ( LINECALLPARAMS)
|
| linePark | lpszDirAddresslpNonDirAddress ( VARSTRING)
|
| linePickup | lpszDestAddresslpszGroupID |
| linePrepareAddToConference | lpCallParams ( LINECALLPARAMS)
|
| lineRedirect | lpszDestAddress |
| lineSetAppPriority | lpszAppFilenamelpszExtensionName |
| lineSetDevConfig | lpszDeviceClass Note: Application must handle conversion of strings in lpDeviceConfig, if these are directly manipulated. |
| lineSetTollList | lpszAddressIn |
| lineSetupConference | lpCallParams ( LINECALLPARAMS)
|
| lineSetupTransfer | lpCallParams ( LINECALLPARAMS)
|
| lineTranslateAddress | lpszAddressInlpTranslateOutput ( LINETRANSLATEOUTPUT)
|
| lineTranslateDialog | lpszAddressIn |
| lineUnpark | lpszDestAddress |
| phoneConfigDialog | lpszDeviceClass |
| phoneGetButtonInfo | lpButtonInfo ( PHONEBUTTONINFO)
|
| 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)
|
| phoneInitializeEx | lpszFriendlyAppName |
| phoneSetButtonInfo | lpButtonInfo ( PHONEBUTTONINFO)
|
| tapiGetLocationInfo | lpszCountryCodelpszCityCode |
| tapiRequestMakeCall | lpszDestAddresslpszAppName lpszCalledParty lpszComment |