| Syntax | BOOL TSPI_phoneSelectExtVersion(hdPhone, dwExtVersion) This function selects the indicated Extension version for the indicated phone device. Subsequent requests operate according to that Extension version. |
| Parameters | HDRVPHONE hdPhone Specifies the Service Provider's opaque handle to the phone for which an Extension version is to be selected. |
| DWORD dwExtVersion Specifies the Extension version to be selected. This version number has been negotiated using TSPI_phoneNegotiateExtVersion. The most-significant WORD is the major version number and the least-significant WORD is the minor version number. Calling this function with a dwExtVersion of zero cancels the current selection. | |
| Return Value | If the function is successful, it returns TRUE, otherwise it returns FALSE. |
| Comments | The Service selects the indicated Extension version. Although the indicated version number may have been successfully negotiated, a different Extension version may have been selected in the interim, in which case this function fails (returning FALSE). |
| Subsequent operations on the phone after an Extension version has been selected behave according to that Extension version. Subsequent attempts to negotiate the Extension version report strictly the selected version or 0 (if the requested range does not include the selected version). Calling this procedure with the special Extension version 0 cancels the current selection. The device becomes once again capable of supporting its full range of Extension version numbers. | |
| Comparison | This function has no direct correspondence at the TAPI level, where selecting an Extension version is bundled with the other functions of phoneOpen. TSPI_phoneSelectExtVersion is typically called in two situations: (1) An application requested to open a phone, the resulting change of Media Mode monitoring was successful, the application requested that a particular Extension version be used, and no Extension version was currently selected. (2) The last application using a particular Extension version closed the phone, and the Extension version selection can be cancelled. |
| See Also | Functions: TSPI_phoneNegotiateExtVersion |