/mcpFunction Details LONG WINAPI lineTranslateDialog( HLINEAPP hLineApp, DWORD dwDeviceID, DWORD dwAPIVersion, HWND hwndOwner, LPCSTR lpszAddressIn ); Parameters hLineApp The application handle that lineInitializeEx returns. If an application has not yet called the lineInitializeEx function, it can set the hLineApp parameter to NULL. dwDeviceID The device identifier for the line device upon which the call is intended to be dialed, so variations in dialing procedures on different lines can be applied to the translation process. dwAPIVersion Indicates the highest version of TAPI that the application supports (not necessarily the value that lineNegotiateAPIVersion negotiates on the line device that dwDeviceID indicates). hwndOwner A handle to a window to which the dialog box is to be attached. Can be a NULL value to indicate that any window that is created during the function should have no owner window. lpszAddressIn A pointer to a null-terminated string that contains a phone number that is used, in the lower portion of the dialog box, to show the effect of the user's changes on the location parameters. Ensure that the number is in canonical format; if noncanonical, the phone number portion of the dialog box does not display. You can leave this pointer NULL, in which case the phone number portion of the dialog box does not display. If the lpszAddressIn parameter contains a subaddress or name field, or additional addresses separated from the first address by CR and LF characters, only the first address gets used in the dialog box. Return Values Returns zero if request succeeds or a negative number if an error occurs. Possible return values follow: • LINEERR_BADDEVICEID • LINEERR_INVALPARAM • LINEERR_INCOMPATIBLEAPIVERSION • LINEERR_INVALPOINTER • LINEERR_INIFILECORRUPT • LINEERR_NODRIVER • LINEERR_INUSE • LINEERR_NOMEM Cisco Unified TAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs 197 Basic TAPI Implementation lineTranslateDialog